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ACORN AT THE BETT SHOW 

In January | took time out from the office to 
visit the BETT (British Education and Training 
Technology) at the Barbican Centre, London. 
The show, on the day | attended, was well 
supported and there was obviously much 
interest in what the various companies had 
to offer. 


Given the dominant position of Acorn in the 
schools market in the UK (where something 
like three quarters of all computers installed 
are Acorn models), the visitor might well 
have expected that Acorn’s presence, and 
that of other third party suppliers, would be 
overwhelming. Not a bit of it. 


The Acorn stand was half the size of main 
educational rivals Research Machines, who 
also had a separate lecture/presentation 
room seating some 50 people, and another 
small group of stands elsewhere. Even 
Commodore and Atari had larger stands 
than Acorn (but maybe they have more to 
gain in this market). Admittedly, Acorn had 
a further hospitality room for pre-arranged 
meetings with LEA advisers and others. 


| wanted particularly to see and learn about 
CD-ROM for the Archimedes (see the News 
pages), but the single point of 
demonstration was by no means obvious. 
Staff from developers Next Technology were 
most helpful and informative, but where 
was Acorn’s support for what they 
themselves are promoting as a major 
development for educational computing? 
This should surely have been the highlight 
of Acorn’s stand, and featured as such. 


No doubt Acorn put considerable effort into 
their presence at this show, indeed many of 
Acorn’s most senior staff were there. But 
surely Britain's major developer and supplier 
of computers for education can and should 
do better? 
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OPEN DAYS VERSUS SHOWS 
BEEBUG was one of the companies not at 
the BETT show. In the past we have 
attended many shows, particularly those 
which have been Acorn-specific. However, 
both last year, and we believe this year, only 
a single Acorn-specific show, the BBC Acorn 
User Show, has been scheduled. Partly as a 
result, we have held two very successful 
open days on our own premises. We are 
now considering what our future policy 
towards shows should be, particularly with 
regard to the kind of presence which we 
should have (selling a wide range of 
computer products, demonstrating just our 
own software, etc.). We would be 
interested to hear the views of RISC User 
members on this issue. 


MEMBERSHIP CARDS 

Some members of RISC User (and BEEBUG 
our user group for the BBC micro and 
Master series) have queried whether or not 
they have been sent the correct membership 
card. In fact, we use the same membership 
card for both RISC User and BEEBUG 
members. The confusion probably arises 
because BEEBUG is the name of the 
organisation which publishes both 
magazines, and provides all member 
services. It so happens that one of our user 
groups is also called BEEBUG. Membership 
cards show both the names BEEBUG and 
RISC User at the top, together with your 
name, membership number and expiry date 
(the last month of your current 
subscription). It is advisable to keep your 
card handy as it is essential to quote your 
membership number if asked when you 
deal with BEEBUG. Note that joint 
BEEBUG/RISC User members receive just one 
card. MCW 
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CD-ROM 


On display for the first time at January's 
BETT Show was a new CD-ROM drive, the 
result of a joint development project between 
Acorn Computers and Next Technology. With 
a capacity of 550 Mbytes and an access time of 
0.4 secs (claimed to be up to twice as fast as 
competitive systems), the CD-ROM drive 
connects to an Archimedes or A3000 via a 
SCSI card, and comes complete with a 
Compact Disc Filing System (CDFS), which is 
compatible with Acorn’s Econet. 20 or more 
drives can be daisy-chained with a single 
card, giving the potential to store over 11 
Gigabytes of information. The drive can also 
read standard audio compact discs. It will be 
available in March. 


Schools will be able to purchase a complete 
A3000-based CD-ROM system for under 
£2000, or add a CD-ROM drive to an existing 
Archimedes system for around £600 plus a 
SCSI card. Next Technology will also be able 
to make a one-off compact disc for under £300, 
offering schools the possibility of preparing 
their own material. 


For further details contact Next Technology, 
St John’s Innovation Centre, Cambridge CB4 
4WS, tel, (0223) 420222. 


MINERVA KEEP TO THE TIMETABLE 


Minerva Software has released Timetabler, a 
software package for the Archimedes and IBM 
compatibles, which should prove a boon to 
hard-pressed teaching staff who would 
normally need to spend many hours compiling 
timetables at the start of each year. Minerva 
claims that Timetabler can arrange the 
timetable of the largest school in about 10 
minutes once all the data has been entered. It 
can cater for differing lengths of periods, 
breaks, courses which must be scheduled for 
different days, etc., and is capable of re- 
arranging the entire schedule if required in 
an emergency. Once the basic data has been 
incorporated into the system, the timetable 
can be quickly updated each year. The 
software is claimed to be user-friendly, and 
costs £688.85 inc. VAT. Further details can be 
obtained from Minerva Software, 69 Sidwell 
Street, Exeter EX4 6PH, tel. (0392) 437756. 


HELP ON THE WAY 


DT Software have announced the first in a 
range of aids for Archimedes programmers. 
DT-VM is a library of routines suitable for 
linking into programs developed with releases 
2 and 3 of Acorn’s ANSI C compiler. It uses 
virtual memory techniques which increase to 
16 or 32 Mbytes the apparent memory 
available for an application, depending on the 
disc storage available. It allows programmers 
to move bytes, integers and memory blocks 
between real and virtual memory, move data 
between virtual memory and disc, and specify 
the amount of real memory available to the 
virtual memory system. 


DT-VM is ideal for uses where large quantities 
of data have to be processed, removing the 
need to use temporary files or split the data 
into manageable chunks. It costs just £7.00, 
from DT Software, 13 Northumberland Road, 
Leamington Spa, Warwickshire CV32 6HE. 


DOOMED AT LAST 


Devotees of Peter Killworth’s adventure 
games will be pleased to hear that Last Days 
of Doom, the third and final part of his Doom 
trilogy, is due to be released by Topologika 
this month, at the price of £19.95 inc. VAT. 


Topologika can be contacted at PO Box 39, 
Stilton, Peterborough PE7 3RL, tel. (0733) 
244682. 


ACE PRINTER DRIVER IS A STAR 


Archimedes owners with a Star LC-10 printer 
can now obtain a RISC OS printer driver from 
Ace Computing. Costing £15.00 inc. VAT, it 
will also drive all Epson printers with colour 
ribbons. 


For more information contact Ace Computing 
at 27 Victoria Road, Cambridge CB4 3BW, 
tel. (0223) 322559. 


NEW SOFTWARE FROM ACORN 


Acorn are planning to release a MIDI 
software upgrade in the near future. At the 
time of going to press, details of availability 
and price were not yet finalised. 
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Also on the way from Acorn is a new series of 
software packages to be marketed under the 
title of Productivity Tools. The first items to 
appear will be a document processor and a 
spreadsheet, and the first public showing is 
expected to be during March or April. 


For further information on all Acorn 
products, contact Acorn Computers Ltd., 
Fulbourn Road, Cambridge CB1 4JN, tel. 
(0223) 245200. 


COMPETITION WINNERS 


As mentioned in the news pages of our last 
issue, Acorn awarded two Archimedes 410 
colour systems as prizes for the most 
interesting applications involving the 
Archimedes, The presentation took place at 
BEEBUG during January. Mark Shacklady, 
one of the winners, was unfortunately unable 
to attend and his prize was received on his 
behalf, but the other winner, Alan Brian, was 
presented with his Archimedes in person. 


= 


= Bsa! 


Acorn's Warwick Hirst (centre) with the lucky 


prizewinners 


CAD PACKAGE FROM LINEAR 
GRAPHICS 


LinCAD Archimedes is an advanced design, 
draughting and graphic communication 
package from Linear Graphics, providing the 
basis for a sophisticated 2D design tool. 
Extensive use is made of the mouse, with 
pull-down menus and comprehensive help 
screens, and the package is claimed to be easy 
to use. It supports all the commonly used 
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drawing elements, a wide range of editing 
functions, and features such as natural 
scaling, auto-dimensioning and symbol 
libraries. The software supports a wide range 
of plotters and dot-matrix colour printers, and 
the price of the package is £172.50 inc. VAT. 
Linear Graphics are at Unit 39, Mochdre 
Industrial Estate, Newtown, Powys SY16 4LE, 
tel. (0686) 629292. 


DISCTREE UPDATE 


Disctree, from Mitre Software, has been 
upgraded to Release 2. The new version 
incorporates a number of improvements, 
including an improved graphical display; 
extra file-handling capabilities such as 
copying of files, dragging to and from 
applications, creation and deletion of 
directories and subdirectories etc.; optional 
compression of files when using the backup 
facility; and SCSI compatibility. Upgrades are 
free to existing users. Further details are 
available from Mitre Software Ltd., 
International House, 26 Creechurch Lane, 
London EC3A 5BA, tel. 01-283 4646. 


ENGINEERING WORKS 


Two new products have been released which 
are aimed at engineers. From Electronic 
Innovations Ltd. comes the CA100 Cable 
Analyser, which is suitable for an Archimedes 
fitted with a user port podule. The 
instrument comes with a sophisticated suite 
of programs for cable analysis, and will be 
available shortly at a price of £287.50 inc. 
VAT. For further information, contact 
Electronic Innovations Ltd., 84 Kings Road, 
Berkhamsted, Herts HP4 3BP. 


Heating engineers may find the Central 
Heating Calculator from D.J.Holden useful. 
This software package is designed to calculate 
the heat requirements of a building. Costing 
just £15, it is claimed to be comparable with 
other commercial packages costing over £300. 
A cut-down demonstration version is 
available, which is claimed to be perfectly 
adequate for DIY use, and this has been 
included on this month’s magazine disc. 
Further details may be obtained from 
D.J.Holden, 39 Knighton Park Road, 
Sydenham, London SE26 5RN. ay 
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INTO THE 90’S WITH DABS PRESS 


ARCHIMEDES FIRST STEPS 
Beginners Guide to the 
Archimedes & BBC A3000 


This book is the perfect introductory guide to the 
Archimedes, to guide you through the first few months of 
ownership, acting as an easy-to-read supplement to the 
User Guide. 


The book describes in detail how to put the RISC OS Desk- 
top to best use. The Welcome discs contain a wide range of 
useful programs, and these are fully documented. 


But the book also goes beyond this and describes the sort of 
software and hardware additions available to the 
Archimedes owner, and how to choose and install them. 


The many features of this book include: 


* Applicable to all Archinedes with RISC OS 
* Using the Desktop, RAMdisc and ADFS 

¢ Edit, Paint, Draw and Maestro 

* The Task Manager 

* The BBC and PC emulators 

* Hardware and software additions 

¢ Illustrated throughout 


BRAND NEW - RELEASED 23rd JANUARY 
PRICE £9.95 


YET ANOTHER POPULAR DABHAND GUIDE 


INSTIGATOR 


THE ARCHIMEDES SYSTEM MANAGER 


mands to RISC OS, and provides you with additional co: 
mands for memory management, colour definition, screen dis- 
play, cut-and-paste, command archiving, etc. Instigator is the 
only“ command toolkit which allows both Desktop and Com- 
mand Line operation. Features include: 
* Full intelligent memory editor, find and fill 
* Colour-coded disassembler 
* Disc sector editor (ADFS, MS-DOS etc.) 
* Get, put and find bytes on disc 
* Load/save of CMOS RAM data, F-Keys etc. 
« Line editor with text cut-and paste in any application 
* Filename completion from directory list 
* Screen dimmer and brightness control 
* Smooth text scrolling 
* Command line archiving and much much more 
it provides a wealth of very useful features, including just about 
everything offered by other toolkit packages...if you need a toolkit, then 
I can highly recommend Instigator.” RISC User October 1989 


Only £49.95 inc. VAT 
FULL ARC CATALOGUE FREE ON REQUEST 


Cambridge Pascal 
isa comprehensive 
version of the Pas- 
cal language and 
includes many ex- 
tra enhancing fea- 
tures over the stan- 
dard specification 
including full dy- 
namic string han- 
dling, local error 
handling, random 
access files, direct 
access to ‘star’ com- 
mands and RISC 
OS SWI calls. It is 
100% Desktop 
compatible but can 
also be run from the command line. All programs compile 
into fast, efficient machine code. 


CAMBRIDGE 
PASCAL 


Pull featured Pascal Compiler for the Acorn 
Archimedes 


Cambridge Pascal requires any Archimedes running RISC 
OS with at least IMb of RAM. Hard dises and extra 
memory are useful, but the system is perfectly workable 
with this minimum configuration. 

Price £79.95 (£69.52+VAT). Site licences available. Free 
demonstration disc and full specification sheet available 
on request. 


DEMO DISC FREE ON REQUEST 


All-In Boxing 


Thrill to the excit- 
ing world of 
championship 
boxing. Marvel at 
the realistic 
graphics and life- 
like sound and 
speech, in this 
new simulation 
from ace games 
programmer 


+ Gym, skipping and boxing stages 
* Digitised grunts and groans and bells 
* Referee counts with real speech Mark Dixon, 
* One or two player game 
* Installs on hard disc 


Training in the 
gym and skipping 
between rounds 
to prepare for the 
big fight with a 


Only £14.95 inc. VAT range of oppon- 


POST FREE ents. A knockout! 
MORE GAMES IN THE COMING MONTHS 


* Six different opponents 
¢ Superb graphics 


Dabs Press products are available from your local Acorn dealer, or in case of difficulty, direct from Dabs Press (Dept. RU1), 
5 Victoria Lane, Whitefield, Manchester M25 6AL. Tel. 061-766 8423. Fax. 061-766 8425. Postage free in the UK. Prices shown 
include VAT. Foreign deduct VAT and add £2.50 (surface/Europe), £12 (air). Payment by cheque, Access/ MC or Visa. 


A Wimp Front End for the Basic Editor 


Mike Summerton presents a Desktop utility which makes the Basic 


editor easier to use. 


T he Wimp interface provided by RISC 
OS makes running programs and 
organising discs very easy, but many users 
of the Archimedes spend a lot of time 
experimenting and programming in Basic, 
and the lack of a Basic editor that can be 
used from the Desktop is a serious 
omission by Acorn. The BasicEdit module 
is, of course, supplied on Applications Disc 
2 as an aid to program development, but 
this is neither Wimp-based nor multi- 
tasking. As a further disincentive to its 
use, it also now needs to be loaded in from 
disc, unlike previous incarnations on the 
Master and under the Arthur operating 
system. Many people are therefore content 
to slog away at the Basic command line or 
use an ordinary text editor such as Edit, 
neither of which is totally satisfactory for 
most purposes. 


The Bedit application described here is 
a utility to allow the BasicEdit module to 
be used directly from the Desktop. It has 
been designed so that once the application 
is installed on the icon bar, it no longer 
needs to access the same disc, so with a 
single drive you do not have to keep re- 
inserting the original disc during use. 
Being a simple application, it should also 
act as a useful template for those who 
would like to write their own Desktop 
applications. With the price of the RISC 
OS Programmer’s Reference Manual being 
a deterrent to many, applications such as 
this are a major source of information for 
less experienced users. 


The Bedit utility is installed on the 
icon bar in the usual way by double- 
clicking on its icon in the directory viewer. 
Dragging a Basic program onto the icon on 
the icon bar enters the Basic editor with 
the program already loaded. Clicking 
Select on this icon enters the editor with 
no program loaded. Performing either of 
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these actions while Shift is pressed will 
enter the Basic environment, in mode 12, 
instead of the editor, with the program 
loaded in the case of a drag operation. 
Clicking the Menu button on the icon 
allows Bedit to be terminated, removing it 
from the icon bar. 


The program also sets up two function 
keys, Shift-Ctrl-f4 to return you straight 
to the Desktop, and Shift-Ctrl_fl2 to run 
the program directly from the Basic editor. 
You may wish to set up your own keys by 
adding appropriate lines of your own to 
the program. 


SETTING UP THE APPLICATION 

First create an application directory 
with the name !Bedit, using the Create 
Directory option in the Desktop. This 
directory will eventually need to contain 
all the programs and data required by 
Bedit, which are as follows: 


!Run Obey file 
!RunImage _ Basic program 
!Sprites Sprite file 
BasicEdit Module 


Type in the program listing and place 
it in the directory with the name 
!RunImage, together with a copy of the 
BasicEdit module supplied on the RISC 
OS Applications Disc 2 (in the Modules 
directory). 


You may then use Paint to create a 
sprite file called !Sprites, inside which you 
should create a sprite (mode 12, no palette, 
size 34x17) called !bedit to represent the 
application in the filer window. Full details 
on using Paint to create sprites were given 
in Into the Arc - All About Sprites (RISC 
User Volume 2 Issue 10). 


Finally, an Obey file called !Run must 
be created using the Desktop !Edit 
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program. !Run should contain the 
following lines: 

Set BEdit$Dir <Obey$Dir> 

RMEnsure ARMBasicEditor 0.00 RMLoad 

<BEdit$Dir>.BasicEdit 

Wimpslot -min 16K -max 16K 

Run <BEdit$Dir>. !RunImage 
The first line sets Bedit’s own system 
variable BEdit$Dir to hold the path into 
its directory, so if another application 
subsequently resets Obey$Dir, this will 
not affect Bedit; the second line loads the 
Basic editor if not already installed; the 
third ensures there is enough room to run 
the application (16K) and that it does not 
take more space than it needs; and the 
fourth runs the main program. 


A simple way to create the application 
directory, together with the !Run and 
!Sprites files, is to use the Application 
Shell Generator published in RISC User 
Volume 3 Issue 2. 


PROGRAM DESCRIPTION 

The main program first switches on 
the hourglass. PROCinitialise then sets 
up three parameter blocks for passing 
data between the program and the Wimp 
system. These are mblock for holding the 
menu description, iblock for holding the 
description of the icon to be installed on 
the icon bar, and ublock for holding the 
parameters passed back by Wimp_Poll. 
PROCinitialise also sets up a text buffer 
to hold the text and sprite name for use 
when installing the icon on the icon bar, 
and a number of constants used as offsets 
into the icon parameter block. 


SYS “Wimp_Initialise” sets up the 
program as a Desktop task with the name 
!Bedit. PROCinstallicon then sets up the 
icon parameter block to install the 
previously loaded sprite !bedit on the 
right-hand side of the icon bar using the 
Wimp_Createlcon call. Note that the left- 
hand and right-hand sides of the icon bar 
are handled by the Wimp as if they were 
two separate windows with the handles -1 
and -2 respectively. 


A Wimp Front End for the Basic Editor 


Once all the necessary disc accesses 
have been completed, the hourglass is 
turned off and the main program loop is 
entered. This sets up a flag ‘quit’ and then 
repeatedly polls the Wimp until a request 
to terminate the task is received, at 
which point it is closed down, removing 
the icon from the icon bar. 


PROCpoll calls Wimp_Poll with its 
first parameter as 1. This tells the Wimp 
not to bother the application until there is 
something to report, which avoids taking 
up unnecessary time when other 
applications are running. If there is an 
action required, the reason code returned 
by the Wimp is checked to see which 
action has been requested. 


Reason code 6 indicates that a mouse 
button has been pressed with the pointer 
over the Bedit icon, after which 
PROChandle_button determines which 
button has been pressed. If it is the 
Menu button, PROChandle_menu is 
used to set up and display the menu, 
which contains the single option “Quit”. 
The Wimp is left to handle a subsequent 
click on the quit option. If the Select 
button has been pressed, PROCbasic is 
called with a null string as parameter, as 
described below. 


Reason code 9 indicates that an item 
has been selected from the menu, and 
since only the quit option is available, no 
further checks are made before setting the 
‘quit’ flag to true. 


Reason codes 17 or 18 signify that a 
message has been sent from the Desktop 
or from another application to Bedit. 
This is handled by the procedure 
PROCreceive_mess. Information about the 
message is put into the parameter block 
by the Wimp. There are basically two 
types of message to which Bedit needs to 
respond. The first, indicated by ublock!16 
being set to 0, is a request from the task 
manager to close down the task, 
whereupon Bedit sets the ‘quit’ flag to 
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true. The second, indicated by ublock/16 
being set to 3, means that a program icon 
has been dragged to the Bedit icon. The 
full path name of the program is to be 
found at ublock+44, The name will be 
zero-terminated, so FNstring is called to 
convert it into a string, before passing it 
on to PROCbasic. 


PROCbasic first looks to see if the 
Shift key is pressed. If not, then function 
key FO is programmed with the keyword 
EDIT and inserted into the keyboard 
buffer to be picked up by the Basic 
interpreter. At the same time, the 
original contents of FO are restored. The 
other function keys are then redefined to 
allow a fast exit from the editor to the 
Desktop and easy execution of Basic 
programs from within the editor. Other 
lines may be added at this point to 
include your own macros in the editor. 
Note that the operating system 
differentiates between function key codes 
and top-bit set characters by preceding 
the former with a zero character. 
Omitting this zero before the function 
key codes will result in them being 
mistaken for Basic keyword tokens. 


Finally, PROCbasic looks to see if a 
filename has been supplied as a 
parameter, and loads the program if it 
has. 


TWIN 

The program may also be used with 
Acorn’s Twin editor. In this case, you 
should replace the second line of the !Run 
file with: 

Set AliasSTwin <BEdit$Dir>.Twin $*0 
and then alter the function key definition 
in Line 1540 of the main program to read 


“TWIN” instead of “EDIT”. 
10 REM >!RunImage 
20 REM Program BEdit 
30 REM Author Mike Summerton 


40 REM Version A 1.0 
50 REM RISC User March 1990 
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A Wimp Front End for the Basic Editor 


60 REM Program 
70°: 
100 SYS "Hourglass On" 
110 PROCinitialise 
120 SYS "Wimp Initialise", 200, &4B53415 
4,"BEdit" 
130 PROCinstallicon 
140 SYS "Hourglass Off" 
150 quit = FALSE 
160 REPEAT 
170 PROCpoll 
180 UNTIL quit 
190 SYS "Wimp CloseDown" 
200 END 
210 : 
1000 DEF PROCinitialise 
1010 DIM mblock &400:DIM iblock &400 
1020 DIM ublock &400:wind_handle=0 
1030 ix0=4:iy0=8:ixl=12:iyl=16 
1040 flags=20:sub_menu=4 
1050 iblockdata=iblock+24 
1060 ENDPROC 
1070 : 
1080 DEF PROCinstallicon 
1090 iblock!wind handle = -1 
1100 iblock!ix0=0: iblock!iy0=0 
1110 iblock!ix1=64: iblock!iyl=64 
1120 iblock! flags=&1700300A 
1130 $iblockdata="!bedit" 
1140 SYS "Wimp CreateIcon",,iblock TO b 
asich 
1150 ENDPROC 
1160 : 
1170 DEF PROCpoll 
1180 SYS "Wimp Poll",1,ublock TO reason 
1190 CASE (reason) OF 
1200 WHEN 6:PROChandle button (ublock) 
1210 WHEN 9:quit = TRUE 
1220 WHEN 17,18:PROCreceive_mess(ublock 


Subject to Copyright 


1230 ENDCASE 

1240 ENDPROC 

1250 : 

1260 DEF PROChandle button (ublock) 
1270 CASE (ublock!8) OF 

1280 WHEN 2:PROChandle_menu (ublock) 
1290 WHEN 4:PROCbasic("") 

1300 ENDCASE 


A Wimp Front End for the Basic Editor 


1310 ENDPROC 

1320 : 

1330 DEF PROChandle menu (ublock) 

1340 S$mblock="BEdit" 

1350 mblock!12=&00070207 

1360 mblock!16=100:mblock!20=40:mblock! 
24=0 

1370 mblock!28=&80:mblock!32 = -1 

1380 mblock! 36=&07019031 

1390 $ (mblock+40)="Quit" 

1400 SYS "Wimp CreateMenu", ,mblock, !ubl 


1490 : 

1500 DEF PROCbasic (file$) 

1510 *FX 225 1 

1520 IF NOT INKEY(-1) THEN 

1530 *Set Key$Store <Key$0> 

1540 *Key 0 *Key 0 <Key$Store>|MEDIT|M 
1550 *FX 138 0 128 

1560 ENDIF 

1570 *Key 4 <0><&94>SYS"Wimp CommandWin 
dow", -1|MQUIT|M 

1580 *Key 12 <0><&94>RUN|M 


ock-60, 136 1590 IF file$<>"" THEN fileS=" -load "+ 
1410 ENDPROC files 
1420 : 1600 OSCLI("WimpTask Basic"+file$) 


1430 DEF PROCreceive mess (ublock) 

1440 CASE (ublock!16) OF 

1450 WHEN O:quit = TRUE 

1460 WHEN 3:PROCbasic(FNstring (ublock+4 
4)) 

1470 ENDCASE 

1480 ENDPROC 


!AreScan 


ArcScan Il Contains the Following 
Databases: 


RISC User Volumes 1-2 
BEEBUG Volumes 1-8 
The Indexes to the following Archimedes 
Acorn manuals: 
Basic User Guide (Arthur) 
Programmer's Reference Manual (Arthur) 
RISC OS User Guide 
RISC OS Basic Manual 
RISC OS Programmer's Reterence Manual 


Fully 
Customisable 


A user-defined custom file 
allows easy customisation 


1610 ENDPROC 

1620 : 

1630 DEF FNstring(ptr%) 

1640 LOCAL S$:SS$="" 

1650 WHILE ?ptr$:S$+=CHRS$ (?ptr%) 
1660 ptr$+=1:ENDWHILE:=S$ 


ArcScan Ill 


For example: 


has 
tahase wads at Selene 2 mentor 9 


Use ArcScan Il rapid keyword search to find all the references you need. 


a ArcScan 
Frio 


Features 


Fast ARM Code searching 

Mouse controlled 

Runs from the Desktop 

Keyword entry with 
selectable logic 

Fully customisable 

Extensive on-screen help 

Hard copy options 


Gesers] lefersat ine 


1. ff you need to know about Obey Files, enter the words ‘obey’, tiles’ and click on the AND 
logic. All finds in RISC User will be instantly displayed. You can now call up the Acorn Manuals 
indexes and repeat the search to get further references. 

2. To find the SWI name for SW! &400D4, select the naw Programmers Reference Manual 


for other data. from the menu, enter "SW/ &400D4", and the answer appears, complete with page references. 


AreScan Il Dise ¢manual £14.95 members (C1895 non-members Code Ot09A —AreScan Upgrade £7.95 members (£10.95 non-members) Code O110A 
Please add 60pp&p. For upgrade, pase state month of purchase of RU Special Disc... 
Phone your order now on (0727) 40303 or sand your chequa/postal order to the address below Please quote your name and membership number, When ordering by 
Access, Visa or Connect, please quote your card number and the expiry date. 


BEEBUG Ltd, 117 Hatfield Road, St Albans, Herts AL1 4JS. secs (0727) 40303. 
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Pineapple’s Colour Digitiser 


Mike Williams reports on a new real-time colour digitiser from 


Pineapple Software. 


i n compiling this report it should be 
made clear from the outset that we were 
testing a prototype board, and that the 
software and documentation was also in a 
pre-release form. Despite that, the whole set- 
up performed faultlessly, though with 
some limitations in the version of the software 
available to us. The final version of the 
system should provide even more facilities. 


The board itself is a full width board 
which plugs into the backplane of the 
Archimedes (an A310 with 1 MBytes of 
memory in our case). The backplate is 
fitted with both video BNC and RGB input 
sockets, and three rotary controls to 
ensure that you can achieve a well 
balanced video image on screen. 
Installation caused no problems at all. 
The system was tested using a Ferguson 
Videostar connected to a portable JVC 
video recorder, which in turn was 
connected to the digitiser. 


Pineapple's colour digitiser 


The supporting software is currently 
supplied as a module which must be 
loaded into RMA memory. This 
implements 23 star commands and 
corresponding SWI calls. There is also a 
short utility which programs the function 
keys with 12 of the most frequently used 
commands with default parameters where 
appropriate. Provided a video input signal 
is present, loading the key definitions also 
invokes a real-time display of the 


resultant image on the screen. At this 
point the three manual controls on the 
board (Colour saturation, brightness and 
contrast) can be adjusted to give the best 
possible picture, though their position at 
the rear of the machine can make 
adjustment difficult. Once set from a 
given video input signal, there should be 
no further need to adjust these controls, 
as we can confirm. 


The board contains 256K of RAM in 
which to store the video image, 256 pixels 
vertically by 512 pixels horizontally. This 
is quite adequate for storing monochrome 
pictures with up to 256 grey levels, or a 
colour image using 16 bits per pixel 
providing a possible 65,536 colours. 
However, picture quality is as likely to 
depend upon the source as on the ability 
of the board to digitise the incoming 
image. The video RAM is updated 50 
times a second when not displaying on the 
screen, 


The moving video image is displayed 
approximately one quarter full screen 
size, though this is partly dependent upon 
the screen mode in use and other 
parameters specified in the *MOVING 
command. The review software only 
implemented modes 13 and 15, both 256 
colour modes, though the intention is that 
all modes will be supported (generally a 
256 colour mode will be needed for a 
reasonable colour image, but a 16 colour 
mode such as mode 12 will be acceptable 
for a monochrome image with 16 grey 
levels). 


At any time a command can be given 
(or function key pressed) to grab the 
current image from video RAM and 
transfer it to screen RAM. This also 
freezes the current video image until 
*MOVING is again issued. Of course, the 
Archimedes at best can only allocate 8 bits 
per pixel (3 red, 3 green and 2 blue), so the 
video image has to be converted 
(*DIGITISE), with intermediate shades 
being constructed as patterns of other 
colours (dithering). The resulting picture 
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quality is good, bearing these limitations 
in mind, though the most striking results 
are derived from simple images such as 
cartoons. Dithering also avoids 
pronounced contouring of shades that can 
otherwise appear in relatively uniformly 
coloured areas. Although the video image 
is always stored at maximum colour 
resolution, you can specify fewer bits to be 
used in digitising (which speeds up the 
process), 4 bits per colour being 
recommended. 


The digitised image can be processed 
in a variety of ways, as well as 
determining the size and position of the 
rectangular area of the screen to be used. 
The picture can be in monochrome or 
colour, inverted (flipped), in negative (with 
separate control of red, green, and blue), 
and with control over the basic 
primary colours themselves. For 
example, you can display an image in 
red only. It is also possible to control 
the video area which results in an 
enlarged image, but with coarser 
resolution. 


Video images can be saved in 
three different formats. The entire 
contents of video RAM may be saved 
to disc, and restored to video RAM 
later for further processing by the 
digitiser. A full resolution image will 
need 256K, but by reducing the 
number of bits per pixel saved, this 
can be progressively reduced to as 
little as 32K, though clearly with some 
loss of resolution. The digitised image in 
screen memory can be saved, and this 
takes up the least space, while the 
digitised screen image can also be saved 
as a sprite, allowing the image to be 
imported into other packages such as 
Paint, Acorn DTP and Artisan (or Pro- 
Artisan) depending on mode. 


Pineapple claims that additional 
commands will also be implemented, 
including *FOCUS to defocus and sharpen 
an image, “SMOOTH to ‘smooth’ 
rectangular pixel shapes, and *NOISE to 
reduce noise without loss of resolution. 
The software at present does not work 
within a multi-tasking window, but a 
Desktop version is promised for the 
future. The current documentation runs to 


38 pages, generally well written and 
straightforward to follow. The final version 
is promised to be more comprehensive still 
with example program listings, and with 
more demo programs on disc. 


The digitiser will be available in two 
versions, a standard version offering 12 
bits per pixel, and an extended version 
offering the full 16 bits per pixel. The 
higher resolution is only likely to be 
apparent to those capable of producing a 
mode 24 display. For normal 16 and 256 
colour modes as described, 12 bit 
resolution should be adequate. However, 
the difference in cost is only £30, and a 
standard board is easily upgradeable on 
payment of £35. Pineapple says that it 
expects to have boards ready for dispatch 
from the end of February. 


Sample digitised Image in mode 15 


My overall impression is that this is 
likely to prove an extremely useful and 
workmanlike addition to the digitisers 
available for the Archimedes, and at a 
most attractive price. In addition, 
Pineapple Software, although a small 
organisation, has always been noted for 
the quality of their products and this 
latest venture appears to be no exception 
to that rule. For those interested in 
digitising colour images, the Pineapple 
digitiser can be thoroughly recommended. 


Product 
Supplier 


Colour Video Digitiser 

Pineapple Software 

39 Brownlea Gardens 

Seven Kings, 

Mord, Essex (G3 9NL 

Tel. 01-599 1476 

£328.00 inc. VAT (standard) 

£362.00 inc. VAT (extended) AW 


Price 
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HEARSAY Archimedes 
Communications Package 


Hearsay is a comprehensive 

communications package written 

specifically for the Archimedes. Zz 

It is mouse-driven and takes full “ais Index * 
advantage of the WIMP system » 
making it extremely easy to use. 


Hearsay provides extensive oa as 
emulations of all the terminals | ay Hde artes 
you should ever need, including: 

VT220, VT102, Viewdata 
(Prestel), Tektronix and TTNS. 


—_ 
jaan ce Ck 0 Be er 
Ms © 


It is ideal for use with Prestel, 

Telecom Gold and bulletin 

boards, and no technical 

knowledge is necessary. However, 

experienced users will find Hearsay will work with most modems 
Hearsay packed with exciting including: Hayes (Linnet, Amstrad 
features making it an SM2400 etc.), Tandata DTI, Dacom 
indispensible tool. DTI and Magic Modem. 


E fees | 
..thoughtfully presented with a number of excellent features...” Members Price 
PCW 


extremely capable and thoroughly recommended.” $5 ] 75 
ACORN USER - 


MICRONET Econet version and 
it could become the standard comms package for education site licences 
IT Education/Network User available 


Please call for details 
& 


! 
| 
1 
l 
Quite simply, Hearsay is visually stunning and extremely effective.” Stock Code OIOIC | 
I 
I 
I 
| 


Technical Information 


Terminal Emulations: Full feature VT220, VT102. VT52, ANSI, Viewdata, Tektronix. TINS and Teletype 
File Transfer: Configurable XMODEM, YMODEM, YMODEM Batch, SEAlink, Kermit and ASCII. 


Telephone Directory: Up to 100 entries, each containing: name, number, status file, terminal type 
and sign-on string 


Communications: Call, Redial, Connect, Disconnect, Talk To Modem, Reconnect, Short Break 
and Long Break 


Hearsay requires IMB of RAM and is compatible with Arthur 1.2 and RISC OS. 
Send SAE for full specification to: 
BEEBUG, 117 Hatfield Road, St Albans, Herts AL] 4JS. Tel (0727) 40303 Fax (0727) 60263 


The Arched 


Text Processor 


Full word processing of - 


* Invoices 

* Reports 

* Letters 

* Statements 
* Circulars 
* Etc. 


PLUS - 


Tax Point: 2ist Juk 


TarttH Pru 


2 C Widgets > 


Lavetee—f8 
0: Acme Trading Co, Ltd, 
ici 
68 


Premier’s unique Dynamic 
Text feature is a simple yet 
powerful concept which puts 
you the user in complete 
control for the first time. It 
provides - 


+: Automatic data linkage 
between documents. 


O99 ef 53 *k Flexible control over 
document formatting. 


** The simplest printer 
A New Type of Program control yet devised. 


Premier's Dynamic Text and eigen command language combine to provide the best solution to text processing 
problems at home or in the office. It puts the user in greater control than ever before, by offering greater freedom 
and flexibility. All program functions may be modified by the user, while command macros may be written to meet 
any specific user requirement. 


All this is available from just one program, which is ry Agar under RISC-OS, and comes complete with 
220 page user guide, separate word-processor manual, key strips, new 10,000 word thesaurus, for just £120 
plus VAT. 


Premier 3 will be available from the Ist December 1989. This definitive version . 

includes fast 'in memory’ data transfer between other applications, extended Ci le S 

spreadsheet functions, and faster screen refresh. New facilities allow the LTC e tware 
independent control of screen and printer output. Older version discs may be 

upgraded free of charge (including full notes on disc), or complete with the new 


word processor manual and thesaurus, for £17.35 + VAT. 33, Restrop View, 

Purton, Swindon, 
Premier 3 may be purchased directly by phone, quoting your MasterCard Wilts. SN5 9DG 
(Access) or Visa card number, or from your nearest Acorn dealer. Educational Tel: 0793 770021 


discounts and multi-machine licences are available, 


Creating New Screen Modes 


David Spencer shows how to add new screen modes to the ARC. 


I n common with the earlier 6502-based 
BBC Computers, the Archimedes features 
a highly programmable video system, 
allowing a great number of parameters to 
be altered. This gives a large number of 
possible screen modes, only some of which 
are offered by RISC OS as standard. 
Luckily, the operating system provides a 
way to add extra modes, and this is what 
we shall look at in this article. This 
month's magazine disc contains a program 
which will assist in creating new modes. 


MODE ATTRIBUTES 

Before we consider how to define a new 
screen mode, we need to study how the 
attributes, or parameters, affecting the 
mode are specified, and just what 
parameters are needed. 


pixels), and those affecting the software, 
for example the number of OS co- 
ordinates per pixel. 


The hardware parameters are values 
to be written directly to the ARM Video 
Controller (VIDC). This device was 
described in the Under the Lid series in 
RISC User Volume 3 Issue 2. There are a 
great number of parameters that can be 
altered, although only a sub-set of these 
are needed to provide useful results. 
These are shown in table 1. The border 
and display start and end registers 
determine the position of the display on 
the screen. The horizontal parameters are 
given in two-pixel units (e.g. 40 represents 
80 pixels), while the vertical parameters 
are in pixel rows. The reference point is 
the top left-hand corner of the screen. The 
display start and end parameters also 


Function 
Horizontal border start 
Horizontal display start 
Horizontal display end 
Horizontal border end 
Vertical border start 
Vertical display start 
Vertical display end 
Vertical border end 
Horizontal cycle register 
Vertical cycle register 


Parameter Address 
HBSR &88 
HDSR &8C 
HDER &90 
HBER &94 
VBSR &A8 

&AC 

&BO 

&B4 


determine the number of pixels making up 
the display, and hence the amount of 
memory needed for the display. The 
horizontal and vertical cycle registers 
determine the overall size of the display. 
These registers must not be altered when 
using standard monitors, otherwise the 
display will roll. On a multi-syne monitor, 
these values need to be at least as great as 
the border end positions for correct 
operation. 


VDSR 
VDER 
VBER 
HCR &80 


VCR &AO 


Table 1. VIDC Parameters 


Variable Function 


Some of the attributes are obvious, Number 
such as the screen's width and height in 
pixels, while others are more subtle, for 
example, the relationship between 
operating system co-ordinates and actual 
pixels, and the size of the display border 
area. A further complication is that the 
choice of attributes is subject to a number 
of restrictions imposed by RISC OS, the 
Archimedes hardware, and_ the 
capabilities of the monitor in use, 


Mode flags 

Number of chars per line - 1 
Number of text rows - 1 

X screen to OS scale factor 


Y screen to OS scale factor 

Number of bytes in one row 
of pixels 

Total size of screen in bytes 

Number of X pixels - 1 

Number of Y pixels - 1 


The parameters defining the display Table 2. Mode variables 


attributes can be conveniently split into 
two groups - those controlling the 
hardware directly (such as the width in 
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The software parameters correspond 
to the mode variables described on pages 
850 to 852 of the Programmer's 
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Reference Manual. You should note, 
however, that the variables relating to 
colour (3, 9 and 10) should not be altered 
as they are determined by the base mode 
(see next section), and that variable 
number 8 is meaningless under RISC 
OS. The remaining variables are shown 
in table 2. The scale factors (variables 4 
and 5) determine the relationship 
between OS co-ordinates and screen 
pixels. They are the number of places by 
which an OS co-ordinate must be shifted 
right to give a pixel number. For 
example, a value of two indicates that 
there are four OS co-ordinates to each 
screen pixel. 


Software Parameter 
List List 
0 0 
VIDC Base Mode _— Software Base Mode 
VIDC Parameter Mode Variable Number 
VIDC Parameter Mode Variable Value 
VIDC Parameter Mode Variable Number 
VIDC Parameter Mode Variable Value 


“1 J 
Table 3. Parameter list formats 


It would be very tedious to have to 
specify all the parameters for each new 
mode. To solve this, RISC OS allows a 
base mode to be specified, followed by a 
list of parameters. Any parameters not in 
the list are taken from the base mode. 
There are in fact two lists, one for the 
VIDC parameters and one for the software 
ones. The formats are shown in table 3. 
The zero entry at the start is to allow for 
identification in the future when more 
advanced VIDCs are introduced. The base 
mode can be set differently for the two 
lists, though the mode specified for the 
software parameter list must have the 
same number of colours as the new mode, 
otherwise the palette will not be set up 
properly. Both lists must be word-aligned 
in memory. 


The VIDC parameters are composite 
values combining the register address 
(from table 1 ) and the value. The 


composite value is formed using the 
expression: 
(address << 24) + (value << 14) 


IMPLEMENTING NEW MODES 


Any extra modes added to RISC OS 
have to be implemented as part of a 
relocatable module. The reason for this is 
that RISC OS requests a set of mode 
parameters by means of a service call, and 
these can only be received by modules. 
Full details of service calls can be found in 
the section of the Programmer's Reference 
Manual dealing with modules. However, 
the crux of the matter is that RISC OS 
calls the module at an entry point 
specified in the module header, with 
register R1 set to a value to indicate the 
individual service call. 


The service call we are interested in is 
referred to as Service_ModeExtension, and 
has the identifying number &50 (80 
decimal). On entry to the module, register 
R2 holds the number of the mode that is 
to be changed into, and R3 contains the 
configured monitor type. The service code 
should check that the mode number in R2 
corresponds to one of the modes that it 
recognises, and that the monitor type in 
R3 is valid for that mode. If everything is 
alright, then the code should set R3 to 
point to a VIDC list, and R4 to a list of 
software parameters as described above. 
R1 should then be set to zero to prevent 
the service call being passed on to any 
other modules. All other registers, in 
particular RO and R2, should be 
preserved. On exit from the routine, RISC 
OS will use the parameter lists to set up 
the desired mode. 


A special case of the service call occurs 
when R3 is set to -1 on entry. In this case 
RISC OS isn't attempting to change mode, 
but rather needs to investigate the 
software attributes of the mode. One 
common case of this is when plotting a 
sprite that was defined in an extension 
mode, as RISC OS needs to work out how 
to scale the sprite. Incidentally, it is 
perfectly possible to have several sets of 
VIDC parameters to cater for different 
monitor types. For example, an otherwise 
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multi-sync-only mode could be 
implemented using interlace on a 
standard monitor. However, each 
extension mode must have only one set of 
software parameters, otherwise the 
properties of any sprites defined in that 
mode would change if the configured 
monitor type was changed! 


OTHER FEATURES 


While on the subject of creating new 
modes, it is useful to look at two other 
service calls, which while not directly 
concerned with adding modes, are closely 
related. 


The first of these associated calls is 
Service_ModeTranslation (&51). This 
allows monitor types other than the 
standard ones of 0, 1, 2 and 3 for normal, 
multi-syne, hi-res mono and VGA 
respectively. The service call is made 
whenever an attempt is made to enter a 
non-existent mode, and the configured 
monitor type isn't one of the standard 
ones (a non-existent mode is one which is 
neither provided by RISC OS as 
standard, nor provided by an extension 
module). 


Service_ModeTranslation is called 
with register R2 containing the number 
of the mode that couldn't be selected 
and R838 containing the configured 
monitor type. The service code 
should find out the attributes of the 
required mode by making calls to OS 
"Read_ModeVariable”, and use this 
information to select the mode which 
most closely resembles the required one, 
and which works in the given monitor 
type. If the required mode doesn't exist 
for any monitor type, then the service 
code will not be able to find out any 
attributes, and will have to settle for a 
default mode. 


This service call is most likely to be 
used by a module that supports a 
specialist monitor type, but which doesn't 
offer the standard set of modes. For 
example, if the user tried to select mode 
12, the module would have to pick its 
mode which is closest to mode 12. 
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The other service call of interest is 
Service_PreModeChange (&4D). This is 
called by RISC OS before any mode 
change, with register R2 holding the 
mode number. Normally this service call 
is passed on unaltered, and the mode 
change takes place as requested. 
However, if the service is claimed by 
setting Rl and RO to zero, then the 
change is blocked, and the current mode 
remains in effect. Similarly, by zeroing 
Rl and pointing RO to an error block 
(error number followed by error string), 
the error will be reported rather than the 
mode changed. It is also possible to 
change the value in R2 so that an 
alternative mode is selected. However, 
this should be used with caution as the 
result could be confusing to the user. 


This service call is most likely to be 
used when an application has strong 
reasons for blocking particular modes, or 
in the exceptional case when mode 
changes must be avoided. For example, 
this could occur if a routine was directly 
accessing screen memory in the 
background for any reason. 


A MODE-MAKER UTILITY 


Even basing a new mode on an 
existing one, there is still the need to 
write a full module to implement the 
mode. This month's magazine disc 
contains a program to simplify the 
operation by creating the module 
automatically. The program is relatively 
restricted in that only one mode per 
module is allowed, however this could be 
modified. 


When creating a mode-you can specify 
the mode number, the width and height 
(in terms of characters), the number of 
colours, and the OS co-ordinates to pixel 
scale factors. You must also specify 
whether a multi-sync only version of the 
mode should be created if one cannot be 
defined to work on a standard monitor. 
The program automatically chooses the 
appropriate base mode to use. Full 
instructions are provided on the disc, 
which also contains a number of sample 
mode modules. BY 
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PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 
Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so youcan work on many documentsat once and instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 
Power, flexibility, speed, ease of use. PipeDream 3, Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Major features include: 


* many documents loaded atonce ¢ automatic loading of VIEW, 


* intuitive RISC OS user interface ViewSheet, Lotus, First Word For a free brochure, complete and return this coupon 

* displaying and printing Plus, Tab and CSV files PipeDream 3 —) View Professional | 
of pictures within text * automatic saving of VIEW, | Name = | 

* built-in 93,003 word Lotus, Acorn DTP format, Tab paitiess | 
spelling checker and CSV files 

¢ file compatibility with * multifield sorting | | 
PC & 288 PipeDream and * use of all available fonts | ____ Post cade | 
BBC View Professional * 62 spreadsheet functions 

* background recalculation * external references for 3-D | Colon Software, Broadway House,)49-151 St Neors| 

* keystroke compatibility modelling Road, Hardwick, Cambridge CB3 7QJ. England | 
with 288 & PC PipeDream * macro file recorder Fax: 0954 211607 Tel: 0954 211472 
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Bits and PCs 


Andrew Benham provides some tips for users of the PC Emulator. 


ome time has elapsed since RISC User 
published any information on the PC 
Emulator for the Archimedes. Recently a 
new version of the emulator has been 
made available, and it seems a good 
opportunity to provide some further 
information which may be of help to users. 
One of the main problems is the lack of 
documentation on the MS-DOS operating 
system supplied with the emulator by 
Acorn. However, there are a large number 
of books published about MS-DOS, some 
of which are stocked by BEEBUG (see the 
current Retail Catalogue for details). 


The latest version of the PC Emulator 
is version 1.33. This can be downloaded, 
as an archived file which upgrades earlier 
versions, from SID (Acorn’s Support 
Information Database) on (0223) 243642 
or via Micronet. The most obvious benefit 
of the new version is improved floppy disc 
speed. It also incorporates an application 
(called !PC) which is run from the desktop, 
and uses a better method of freeing 
memory than previous versions have 
done. As a result, 584K of memory is now 
available on the A310 for the emulator, 
while on machines with more memory, the 
DOS addressable limit of 640K is easily 
achieved. The new version also allows the 
user to specify the filename for the PC 
partition on a hard disc. The default is 
still ‘$.PC.Drive_C’ as before, but a tidier 
disc structure can be achieved by placing 
the “Drive_C” filename within the !PC 
application directory. 


CONFIGURATION 

There are two files on a PC system 
which allow the user to customise the 
machine. These files should exist in the root 
directory of the boot disc (i.e. the dise from 
which DOS is loaded), and are named 
CONFIG.SYS and AUTOEXEC.BAT. Both 
these files may be created using a text 
editor such as EDLIN. 
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The CONFIG.SYS file is a text file 
containing configuration commands, one 
to each line. These are special commands 
which can only be used within a 
CONFIG.SYS file, and not at the user 
prompt. The commands are in general 
those which affect the overall set-up of the 
computer (such as the floppy disc drive 
configuration - see below). For example: 

COUNTRY=044 
sets the time, date and currency format to 
the United Kingdom defaults, which is 
recommended for UK users. Datestamps 
displayed on files will then be in the 
European format (dd-mm-yy) rather than 
the American (mm-dd-yy). 


As another example, the operating 
system normally only checks to see 
whether the user wishes to terminate the 
current activity (i.e. by pressing Ctrl-C) 
when the application needs to read the 
keyboard or when writing to the screen or 
printer. Including the line: 

BREAK=ON 
in the CONFIG.SYS file causes checks to 
be made during other functions as well, 
which may result in a speedier response 
under certain circumstances. 


Modifications to the configuration only 
come into effect when DOS is next 
restarted. This may be achieved by 
pressing Ctrl-Alt and Delete 
simultaneously to force a reset. Note that 
DOS regards the keypad ‘.’ key as being 
equivalent to Delete (provided that the 
“Num Lock” LED on the keypad is off). 
Similarly, the keypad keys 8,4,6 and 2 are 
interpreted as cursor movement keys (up, 
left, down, right respectively); keypad 7 is 
interpreted as Home, keypad 1 as End, 
keypad 9 as Page Up and keypad 3 as 
Page Down. 


The second configuration file is 
AUTOEXEC.BAT. This is also a text file, 
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but is more akin to an Archimedes !Boot 
file, in that it can contain a number of 
standard statements which are executed 
automatically when DOS is started, 
rather than having to be typed in at the 
prompt. For example: 

PATH <pathname> 
can be used to set up the required DOS 
path automatically. Similarly: 

DIR 
will show you a listing of the contents of 
the root directory on start-up. 


If DOS cannot find an 
AUTOEXEC.BAT file in the root 
directory of the boot disc when started 
up, it issues a prompt to set the current 
date and time. Since the Archimedes 
maintains this information 
automatically, it is worth having an 
AUTOEXEC.BAT file just to avoid this 
nuisance; however, there are several 
other useful commands which could be 
included. For example: 

VERIFY ON 
ensures that all bytes written to disc are 
read immediately to check that they have 
been saved correctly, at the expense of a 
slight loss of speed on disc operations. The 
function can be turned off at any time 
with: 

VERIFY OFF. 


A frequent customisation option 
included in AUTOEXEC.BAT is to set the 
user prompt. Under normal circumstances 
this is displayed as the current drive 
letter, for example: 

Cs> 
However, you can alter this, by using the 
command PROMPT followed by the text 
which is to be used as the new prompt. So 
if you feel your machine is rather 
impersonal in the way it addresses you, 
you could introduce a note of politeness by 
including the line: 

PROMPT Please enter a command 
There is a range of special characters for 
use with the PROMPT command, which 
should each be preceded by a ‘$’ character. 
These characters are: 


time 

date 

full directory pathname 
drive 

DOS version number 

> 


omm < 5b Oct 


< 

vertical bar | 
<newline> 

<Space> (only needed if 
first char of prompt) 

e <Escape> 

$ The $ character itself 


So the default prompt, for example, would 
be produced by “PROMPT $n$g”. A 
frequently used alternative is “PROMPT 
$p$g” which prints the directory 
pathname terminated with “>”, 


If an AUTOEXEC.BAT file consists of 
several lines, you may find it annoying 
that the commands appear on the screen 
as they are executed. This may be 
prevented by inserting the line: 

ECHO OFF 
at the start of the file. This line itself will 
still be displayed, but subsequent 
commands will not. Should you wish to 
display a message on the screen at some 
later point in the AUTOEXEC.BAT file, 
then the command: 

ECHO <text to be displayed> 
could be included. The text cannot be the 
strings ‘on’ or ‘off’ however! 


The AUTOEXEC.BAT file may also 
include any other command which you wish 
to be executed each time DOS restarts, 
including the installation of programs. For 
example, there are public domain programs 
which record the most recently used 
commands, and allow the user to recall 
these commands at the touch of a key 
(usually Cursor Up). Such programs 
(DOSEDIT being one of the better-known) 
may conveniently be installed at start time 
in this way. Another public domain 
program, called CED, also allows the user 
to establish synonyms for commands: e.g. ‘d’ 
can be defined to mean ‘dir’, and ‘ty’ to 
mean ‘type’. This helps to get around the 
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lack of abbreviations in DOS compared with 
other operating systems. 


FORMATTING 360K DISCS 

The PC Emulator uses the 720K floppy 
disc format for the internal 3.5” floppy 
drive, and this configuration also applies 
to external drives if fitted. Often the 
external drives used on the Archimedes 
are 5.25” floppy drives to enable discs 
from older BBC Microcomputers to be 
used. With external double-sided 40 track 
5.25” drives (and a suitable interface) the 
PC Emulator can read from and write to 
both 720K and 360K 5.25” discs. However, 
as the default configuration specifies that 
all drives are 720K devices you cannot 
format 360K discs with the system as 
supplied. In order to solve this particular 
problem, it is possible to alter the 
configuration of the PC Emulator so that 
the external 5.25” drives are seen as 360K 
format devices. This alteration does, 
however, prevent the external drives from 
accessing 720K discs, although the 
configuration may be readily altered back 
to the previous setting. 


The CONFIG.SYS file can be used to 
modify the floppy drive set-up, adding a 
line for each drive to be altered. The full 
format of the command is: 

drivparm=/d:<drive> [/f:<format>] [/h: 
<heads>] [/s:<sectors>] [/t:<tracks>] 


where: 

<drive> is a number, with 0 
corresponding to A, 1 to B etc. 

<format> is 0 for 360K, 2 for 720K. 

<heads> is the number of heads, 1 for 
single sided or 2 for double 
sided (the usual format). 

<sectors>is the sectors per track, 
i.e. 9 for both 860K and 720K. 

<tracks> is the tracks per side, 
i.e. 40 for 360K, 80 for 720K. 


Thus to set drive B to be a a 360K 
device, include the following line in the 
CONFIG.SYS file: 

drivparm=/d:1 /£:0 /h:2 /s:9 /t:40 
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USING EXTERNAL DRIVES 

The Archimedes as standard does not 
support the use of external drives. Disc 
buffers are available from a number of 
third-party suppliers, including BEEBUG, 
which allow the connection of external 
drives. It is important to realise that in 
general, older drives require a longer time 
to step between tracks, and the rate at 
which the disc controller in the 
Archimedes does this can be configured 
for each drive by the following command: 

*CONFIGURE STEP <rate> [<drive>] 
where <rate> may be 2, 3, 6 or 12ms. If 
<drive> is omitted the rate will apply to 
all drives. Drives may be unreliable, or 
not work at all, if the computer is 
attempting to step the head at a faster 
rate than the drive mechanism can cope 
with. 


The Archimedes does not support 
double-stepping, which is needed to 
allow 80 track drives to access 40 track 
discs; however, external drives and disc 
buffers are available with hardware 
which can introduce double stepping. 
This is achieved by electronically 
inserting extra step pulses after the 
pulses sent by the computer, so that the 
drive mechanism receives twice as many 
as the computer sends. So if the external 
drive is only just capable of operating 
with the configured step delay in 80 
track mode, then the extra step pulses in 
40 track mode will be too close together 
in time and the drives will not step 
correctly. The step delay for drives used 
in double-stepping mode should 
therefore be increased beyond the delay 
required for reliable operation in 80 
track mode. This may become more 
noticeable using version 1.33 of the PC 
Emulator, as the drive step delay is read 
from the CMOS RAM configuration, 
rather than the slow default used in 
earlier versions of the emulator. 


We hope to include further information 
on using the PC Emulator in a future 
issue of RISC User. 0) 
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Pop-up Menus 


This utility from David Miller allows you to add pop-up menus 


to non-Wimp programs. 


ISC User Volume 2 Issue 9 contained a 
pop-up file selector which could be used with 
non-Wimp programs. The utility described 
here allows you to add pop-up menus, and 
consists of a set of procedures and functions 
to be added to any program. 


The core of the utility is a function, 
FNmenu, which is called any time a menu is 
required. All menus must be contained within 
a set of DATA statements occupying 
consecutive program lines. Each DATA 
statement consists of a string in the format 
<title>,<option1>,<option2>, <option3> etc. 
Options which lead to a sub-menu should be 
followed by a further list, of identical format 
to the above, enclosed within square brackets. 
You may find it useful to indicate on the menu 
which items have sub-menus. The neatest 
way to do this is to copy the Wimp and 
include an arrow, as in the example below, 
which can be entered from the keyboard by 
pressing Alt, typing 137 on the numeric 
keypad, then releasing Alt again. 


Each complete menu tree definition must be 
defined in a single DATA statement. After the 
last DATA line you must include a further 
DATA line containing the string “END”. An 
example definition of a menu tree might be: 


DATA "Main Menu,File ->[File Menu,Load, 


Save,Cat],Search ->[Search Menu,Print, 
Normal], List, Quit” 
This sets up a menu with the title Main 
Menu, containing the options File, Search, 
List and Quit. File and Search both have 
sub-menus, with three options in the former 
and two in the latter. 


When the final selection is made, the 
function returns a string containing numbers 
which represent the complete branch 
structure of the options selected, in the 
format “.<sl>.<s2>.<s3>” etc. If in the 
example shown above the user has selected 
Save from the File menu, the string returned 
would be “.1.2”, i.e. option 1 of the first menu 
followed by option 2 of the next sub-menu. 


Pressing Adjust will move back one 
level, or if already at the top level, will exit 
from the function and return a null string, 
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HOW TO USE THE FUNCTION 

PROCmenu_init must be called once by 
the main program, before any call is made 
to FNmenu, in order to count the menus in 
the DATA statements, assign each one to an 
element of the array menu$, and allocate a 
block of memory for the user sprite area. 
The latter is required to enable the function 
to save, as a sprite, the area of the screen to 
be covered by each menu. 


Before each call to FNmenu, the pointer 
must be turned on with the command 
*Pointer 1, and the screen co-ordinates of 
the bottom left-hand corner of the menu 
specified in xmenu and ymenu. You can also 
define your own colours for the menu at this 
point; Colour 1 is used for the menu border, 
colour 3 for the title and for the bar which 
indicates which item the pointer is over, and 
colour 4 for the menu background. Trial and 
error can be avoided by using the RISC 
User Screen Manager which was published 
in Volume 1 Issue 5, and is included again 
on this month’s magazine disc. 


FNmenu is then called with two 
parameters: menu$(x), where x is the 
position of that menu in the list; and 0, 
which is the starting level of the menu tree 
(for sub-menus FNmenu calls itself 
recursively, increasing the level number). 


The program listing includes, in lines 
100-220, an example of how to call the 
function. It simply displays a list of the 
resident modules on the screen, using the 
*Modules command, and pops up the menus 
over the top. No actions are performed on 
selection - it is merely a demonstration of 
the effect. The RESTORE statement in line 
100 should point to the first DATA line 
containing the menu strings. 


10 REM >!RunImage 
20 REM Program Pop-up Menus 
30 REM Version Al.0 


40 REM Author David Miller 

50 REM RISC User March 1990 

60 REM Program Subject to Copyright 
10 : 

100 MODE12:RESTORE 2190 
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110 PROCmenu_init 
120 *Modules 
130 *Pointer 1 
140 xmenu=96: ymenu=320 
150 COLOUR 1, 50,180, 50 
160 COLOUR 3, 250,200,130 
170 COLOUR 4,75,100,75 
180 option$=FNmenu (menu$ (0), 0) 
190 REM Process menu selection 
200 REM returned in option$ 
210 *Pointer 0 
220 END 
230: 
1000 DEF PROCmenu_init 
1010 LOCAL spSize%, it, menus$, sizet 
1020 menust=FNcount_menus 
1030 DIM menu$ (menus$-1) :spSize%=0 
1040 FOR it=0 TO menus$-1 
1050 READ menu$:menu$ (it) =menu$ 
1060 sizet=FNspritesize(menu$) 
1070 IF spSize%<size% spSizet=sizet 
1080 NEXT i% 
1090 DIM menu_spAreat spSize%+16 
1100 menu_spArea%!0=spSize%+16 
1110 menu_spArea%!4=0 
1120 menu_spArea$%!8=16 
1130 menu_spAreat!12=16 
1140 ENDPROC 
1150 : 
1160 DEF FNcount_menus 
1170 LOCAL menus?,menu$:LOCAL DATA 
1180 menus$=0:READ menu$ 
1190 WHILE menu$<>"END” 
1200 menus$+=1:READ menu$ 
1210 ENDWHILE 
1220 =menus% 
1230 : 
1240 DEF FNspritesize (menu$) 
1250 LOCAL entry$,entriest, width, max, 
size%, submenu$ 
1260 IF menu$="" THEN =0 
1270 entriest=0:width?=0:maxt=0 
1280 WHILE menu$<>"" 
1290 + entries%+=1 
1300 entry$=FNget_entry(menu$) 
1310 submenu$=FNget_submenu (entry$) 
1320 IF width$<LEN(entry$) widtht=LEN 
(entry$) 
1330 sizet=FNspritesize (submenu$) 
1340 IF maxt<sizet maxt=sizet 
1350 ENDWHILE 
1360 =44+(entriest+2) * (widtht+2) *32+ma 
xt 
1370 : 
1380 DEF FNget_entry(RETURN menu$) 


1390 LOCAL lev3,entry$ 

1400 levt=0:entry$="" 

1410 WHILE (LEFT$(menu$,1)<>"," OR levi 
>0) AND menu$<>"" 

1420 CASE LEFTS$(menu$,1) OF 

1430 WHEN "[": lev$+=1 

1440 WHEN "J": levt-=1 

1450 ENDCASE 

1460 entry$+=LEFTS (menuS, 1) 

1470 menu$=MID$ (menu$, 2) 

1480 ENDWHILE 

1490 menuS=MIDS$ (menu$, 2) :=entry$ 

1500 : 

1510 DEF FNget_submenu (entry$) 

1520 LOCAL i$:it=INSTR(entry$,"[") 

1530 IF i THEN =MID$(entry$, i$+1,LEN(e 
ntry$)-1) ELSE ="" 

1540 : 

1550 DEF FNmenu(0$, lev) 

1560 LOCAL mop$ (),sub$(), num, N,C$,width 
,xwidth, ywidth, MX, MY, MB, Mb, ch$, ch 

1570 DIM mop$ (20), sub$ (20) 

1580 ch$="":width=0 

1590 mop$ ()="":sub$ ()=""": chosen=FALSE 
1600 O$+="|":num=1:FOR N=1 TO LEN(0$) 
1610 C$=MID$ (0$,N, 1) 

1620 CASE C$ OF 

1630 WHEN ",":IF LEN(mop$(num))>width w 
idth=LEN (mop$ (num) ) 

1640 num+=1 

1650 WHEN "|":IF LEN(mop$(num))>width w 
idth=LEN (mop$ (num) ) 

1660 WHEN "(":PROCgetsubdata 

1670 OTHERWISE mop$ (num) +=C$ 

1680 ENDCASE 

1690 NEXT N 

1700 xwidth=16* (width+2) 

1710 ywidth=32* (num+2) 

1720 MOVE xmenu, ymenu 

1730 MOVE xmenu+xwidth-2, ymenutywidth-4 
1740 SYS "OS SpriteOp", &10E,menu_spArea 
%, "menuspr"+STRS$ lev, 0 

1750 REPEAT 

1760 GCOLO,1:RECTANGLE FILL xmenu, ymenu 
, xwidth, ywidth-4:GCOL0,4:RECTANGLE FILL 
xmenu+4, ymenu+8, xwidth-8, ywidth-20 

1770 VDU5:GCOL0, 3 

1780 MOVE xmenu+16, ymenutywidth-16 

1790 PRINTmop$ (1) 

1800 GCOLO,1:RECTANGLE FILL xmenu, ymenu 
+ywidth-60, xwidth,8 

1810 GCOLO,7 

1820 FOR N=2 TO num 

1830 MOVE xmenu+16, ymenu+ywidth-48-(N-1 
)*32 
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Copy/Wipe Options Setter —— 


by Mike lronmonger 


For reasons of space, this program is 
supplied only on the magazine disc. 


This is a very simple utility which 
allows you to use a multi-tasking window 
in the Desktop to set the various options 
for the *Copy, *Wipe and *Count 
commands, which are used from the 
command line. The Force and Stamp 
options also affect copy operations 
performed from the Desktop by dragging 
files from one directory viewer to another, 
but the other options do not. Note that this 
is not an omission by the program, but the 
way the Desktop has been designed! 


The utility is installed on the icon bar, 
and clicking on the icon opens a window 
which shows all the options for the three 
commands, together with a single-line 
description of the effects of each, and an 
icon which displays the current state of 
each option. Clicking Select on an entry 
alters the option state from on to off or 


Pop-up Menus 


1840 PRINTmop$(N) :NEXT N 

1850 MOUSE RECTANGLE xmenu, ymenu, xwidth 
,ywidth-64 

1860 GCOL3, 7: VDU4:OFF 

1870 REPEAT: MOUSEMX, MY, MB 

1880 ch=(ymenut+tywidth-MY-36) /32 

1890 cheINTch:IF ch>num-1 ch=num-1 

1900 IF ch=0 ch=1 

1910 RECTANGLE FILL xmenut4, (ymenutywid 
th-76)-ch*32,xwidth-8, 32:WAIT 

1920 RECTANGLE FILL xmenut4, (ymenutywid 
th-76) -ch*32, xwidth-8, 32 

1930 UNTIL MB=4 OR MB=1 

1940 REPEAT:MOUSEMX, MY, Mb:UNTIL Mb=0 
1950 IF MB=4 THEN 

1960 ch$t="."+STRSch 

1970 IF sub$(ch+1)<>"" xmenut=100;ymenu 
+=50:Z$=FNmenu (sub$ (ch+1), lev+1) :PROCpro 
cess:xmenu~=100;:ymenu-=50 ELSE chosen=TR 
UE 

1980 ENDIF 

1990 UNTIL chosen OR MB=1 

2000 MOUSE RECTANGLE 0,0,1279, 1023 

2010 MOVE xmenu, ymenu 
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vice versa. The changes are made 
immediately, and if you exit the Desktop 
and type *Show, you will see the new 
options reflected in the variables 
Copy$Options, Wipe$Options and 
Count$Options. Note that if the option 
letter is preceded by a tilde character (~) 
this means that the option is currently 
turned off. 


Clicking on the Menu button in the 
window allows you to restore the default 
setting for any of the three commands, or 
to save or load sets of options. This could 
be useful,.for example, if you wish to do 
some disc copying using a particular 
combination of copy options. If you simply 
drag the options file to the icon on the icon 
bar, or double-click on it once the filer has 
“seen” the !FS_OptSet application, the 
options will be loaded. This will save you 
having to type in all the options after the 
*Copy command and perhaps having to 
refer to your manual as you go. RY 


2020 SYS "OS_SpriteOp", 611C,menu_spArea 
%,"menuspr"+STR$lev,,,0 

2030 =ch$ 

2040 : 

2050 DEF PROCprocess 

2060 ch$+=2$ 

2070 IF Z2$="" N=LEN(ch$) :REPEAT:N-=1:UN 
TILMIDS (ch$,N,1)="." OR N<l:ch$=LEFTS$ (ch 
$,N-1) 

2080 ENDPROC 

2090 : 

2100 DEF PROCgetsubdata 

2110 open=1:sub$ (num) ="";:REPEAT: REPEAT 
2120 N+=1:C$=MID$ (0$,N, 1) 

2130 sub$ (num) +=C$ 

2140 UNTIL CS$="[" OR CS$="]" 

2150 IF CS$="(" opent=1 ELSE open-=1 
2160 UNTIL open=0 

2170 sub$ (num) =LEFTS (sub$ (num) ) ; ENDPROC 
2180 : 

2190 DATA “Main Menu,File 4[File Men 
u,Load,Save,Cat],Search 4[Search,Print, 


Normal), List, Quit” 


2200 DATA "END" wy 
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INVESTIGATOR 1.02 


£24.95 


THE SERIAL PORT 


Investigator is a disc utility program which is compatible 
with the Archimedes 300, 400 and 3000 series using 
either the Risc OS or Arthur 1.2 operating systems. 
Investigator can perform the following operations on discs 
of many different formats: 


@ Examine the format of the disc in detail. 
e Edit the data stored on the disc. 
@ Make backup copies of the disc. 


e Store the entire disc as an ordinary ADFS file. This 
may allow archives of several master discs to be stored 
on a single backup disc. The disc may then be 
transmitted to a remote site using a modem and a 
communications package such as ARCterm. 


e@ Fully WIMP front end. 


The Serial Port, Burcott Manor, Nr Wells, Somerset BA5 INH 
Voice (0749) 72234 Data (0749) 79794 (300-2400 baud) 


Please send me [_] INVESTIGATOR 1.02 at £24.95, cheque, PO enclosed. 
[_] Data Sheet 


Name 
Address 
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The Qume Crystalprint Publisher 


Qume’s Crystalprint Publisher appears to offer exceptional value for 
money. Lee Caicraft tests it out on the Archimedes. 


ast month we reviewed the 
Panasonic KX-P4450 laser printer, 
which provides a Hewlett Packard 
LaserJet emulation. This month we 
take a look at the other side of the 
coin: a PostScript printer. But the 
Crystalprint Publisher differs in a 
number of respects from traditional 
PostScript page printers such as the 
Apple LaserWriter. In the first place 
it does not make use of laser 
technology. Instead of scanning the 
light sensitive drum with a laser 
beam and rotating mirror, the print 
engine inside the Publisher uses an 
array of liquid crystal shutters. Its 
manufacturers argue that this 
involves less moving parts, and is 
therefore less prone to failure. It also 
means that it is not strictly speaking a 
laser printer at all, though it is still 
convenient to use this generic term. 


A REVOLUTIONARY PRINTER 


The Publisher is also revolutionary in 
that it is in fact a PostScript clone rather 
than an officially licensed Adobe 
PostScript machine; and as a result, 
retails with an RRP of £2999 ex. VAT, but 
is available for around £2500 inc. VAT. 
The machine houses a very powerful 32- 
bit RISC processor, which runs at 4 MIPs 
(the same speed as the ARM2), and gives 
a truly staggering speed performance, as 
we shall see in a moment. 


The Publisher is a 300 dpi (dots per 
inch) mono page printer with 3 Mbytes of 
RAM and 1.5 Mbytes of ROM. It is a very 
compact machine, measuring just 15.5 by 
13.5 inches, and is just 9 inches high. It 
takes around half the desk space of the 
Panasonic reviewed last month. To 
achieve this, its single paper tray (which 
holds just 100 sheets) slides right 
underneath the machine. This means that 
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Qume's Crystalprint Publisher 


the paper must go through two tight 
bends before it arrives in the collection 
area at the top of the machine. In view of 
this it may be best to avoid using paper in 
excess of 80gsm. 


The front panel provides adequate 
control over the printer, though is limited 
by the use of a two-digit LED display, 
which is obviously less user friendly 
than the 18 character LCD display of the 
KX-P4450. Important options such as 
which of the three ports is to be used 
(RS232, Centronics parallel or Appletalk), 
serial port parameters, page orientation, 
etc. are held in non-volatile RAM, and so 
can be set up once and for all. For use with 
the Archimedes, I used the Centronics port, 
connecting it up with a standard lead. 


POWERING IT UP 

The Crystalprint takes about a minute 
to warm up from cold, and then prints a 
start-up page in a similar way to the 
Apple LaserWriter. But with the Qume, 
you can turn off this facility by running 
the program given in the accompanying 
listing. To reinstate the start-up page, re- 
run the program, with the word “false” 
replaced by “true” in line 150. 
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The Qume Crystalprint Publisher 


10 REM >PSpageoff 
20 REM Turns off First page 
30: 
40 vDU2 
50 REPEAT 
60 READ A$ 
70 IF AS<>"ZZ2" THEN PRINTAS' 
80 UNTIL A$="222" 
90 VDU3 
END 


DATA serverdict begin 
DATA 0 exitserver 

DATA statusdict begin 
DATA false setdostartpage 
DATA end 

DATA 222 


Basic program for generating a PostScript 

output to turn off the Publisher's start-up 

page. You do not need the driver installed 
to use this program. 


To get any output from the Publisher, 
you will need to install the Archimedes 
PostScript printer driver on the icon bar 
by double clicking on its icon from a 
directory viewer (the latest version of the 
driver was supplied on the RISC OS 
extension disc - copies available from 
BEEBUG). Once installed, you may need 
to alter its configuration by clicking Menu 
over the icon. This brings up a menu of 
choices, and allows you to set the driver to 
output to the parallel or serial port, to the 
network or to a file. This latter can be 
very useful even if you do not have a 
PostScript printer, because the file can be 
used at a later date on other PostScript 
set-ups - including typesetting machines 
capable of 1000 dpi or greater. When you 
have selected the appropriate option, 
clicking on “Save choices” will save your 
selection for future use. 


Printing is then a simple matter. To 
print a Draw file, just drag its icon to the 
driver icon. Providing that RISC OS has 
seen the Draw application it will load it if 
it is not already resident, then generate 
PostScript code and send it to the printer. 


As we have already mentioned in previous 
articles, PostScript is a programming 
language in its own right, and the 
PostScript driver in the Arc actually 
generates a program which the processor 
inside the Publisher executes as it 
receives it. This is very different from the 
LaserJet approach (used on the KX-P4450 
reviewed last month), where the Arc sends 
a complete pixel map of the image, one 
byte at a time. The latter process is 
relatively slow, largely because it involves 
sending up to a megabyte of data through 
the parallel port for every A4 page 
printed. By contrast, the entire PostScript 
program for such a page might typically 
be as little as 20 or 30K in length. 


Printing from Impression or Acorn 
DTP is accomplished in a similar way. You 
can either drag a file to the driver, or 
select the Print option from within the 
package. The same is true for a straight 
text file. Dragging a file of type ASCII to 
the PostScript driver will cause it to be 
output efficiently in the Courier font. 
However, applications which do not use 
the printer drivers cannot be used so 
easily. To print out a Basic program on the 
Publisher, you must first create an ASCII 
file (using *SPOOL for example), and then 
drag the resultant file to the driver. The 
reason for this is that the PostScript 
interpreter will not print out ASCII text 
which is sent directly to it: it must be 
parcelled up into a PostScript program. 
And secondly the Publisher has no other 
emulation - it will only run PostScript. 
But this distinct drawback of the 
Publisher is due to be remedied shortly, 
with a new model which has both 
PostScript and LaserJet emulation. 
Unfortunately it will not be possible to 
upgrade from the present Publisher to 
this new version, I understand. 


While on the subject of upgrades, there 
are two points to make. Firstly, the 
Publisher is actually one of a family of 
three page printers based on the same 
print engine, and Qume offer an upgrade 
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4 Impression Pages 


The Qume Crystalprint Publisher 


path between them for a price equal only 
to the difference in retail price of the 
models concerned. Readers may well find 
it worth considering the Crystalprint 
WP+, which provides LaserJet emulation, 
for around half the cost of a Publisher. For 
details of this, and the cost of upgrades, 
see your nearest Qume dealer. 


Secondly, I must mention that early 
versions of the Publisher would not work 
on the Archimedes parallel (Centronics) 
port. Qume have now remedied this in the 
latest version of the printer’s ROM. But if 
you have a firmware version lower than 
3.03, Qume will upgrade your printer 
free of charge (see details at the end of 
this article), 


TIMINGS 

If you look at the timing chart in 
figure 1, you will find comparisons 
between the Qume and the Panasonic 
KX-P4450 reviewed last month. At 6 
pages per minute, the Casio engine used 
in the Qume is considerably slower than 
the more substantial, and faster 
Panasonic engine, but the speed 
equation is much more complex than this 
suggests. If you are using your machine 
for printing ASCII text (such as long 
program listings), then the two figures of 
6 and 11 ppm respectively are directly 
applicable. But for printing Draw files, or 
DTP documents, or even dumping screens, 
the Publisher gives much faster results. 


Panasonic 
KX-P4450 


Qume 
Publisher 


First Sheet Out 20s 
Time Between Pages 10s 
Pages Per Minute 6 


Standard Draw File 39s 
Mode 12 Screen 53s 
A4 Impression Page 34s 


im 05s 21m 35s 


Figure 1. Timings for the Crystalprint Publisher 


and the Panasonic KX-P4450 


In the case of a two-column A4 page of 
text created in Impression, and using two 
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different fonts, the timing difference is 
quite staggering. This is not a misprint (or 
a mistiming). The Publisher took just 34 
seconds to print the test page, while the 
Panasonic took 5 minutes 32 seconds. And 
this is quite typical of such timings. 
Moreover, 20 seconds of the 34 taken by 
the Publisher are the overhead for the 
first page out. On a run of such pages 
from a document, the time between pages 
is just 10 seconds, giving a total time to 
print 4 pages of 65 seconds. The KX-P4450 
took more than 20 minutes to print the 
same 4 pages. 


Figure 2. The Publisher generates high 
quality output at great speed 


The quality of output from the 
Publisher is excellent, and comparable in 
every way with that of the Panasonic, 
both in its rendering of solid blacks, and 
in the quality of its fonts. Like all 
PostScript page printers, the Publisher 
must contain data for creating all the 
fonts which appear on the page. LaserJet 
machines by contrast do not need a wide 
variety of fonts, because in page mode 
they are just reproducing bit-maps created 
inside the computer using its resident 
fonts. The Publisher is well endowed in 
this area, containing 39 resident typefaces 
in 11 font families, supplied mostly by 
Bitstream (again avoiding the Adobe 
copyright). The names of these are given 
in figure 3. An option from the front panel 
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~~) I6BIT SCSI 


Winchesters and 


controller card for 
300/400/A3000. Exceptionally fast. Up to 


7 devices per card. Internal drives come 


with all necessary mounting hardware. 
External drives have their own PSU and 
fan.Please specify if for A3000. 


Internal (inc. card) External (inc. card) 


20Mb = £375.00 + 20Mb £535.00 
45Mb £495.00 45Mb £655.00 
70Mb-~—s £895.00 70Mb ~~ £1055.00 
135Mb £1595.00 90Mb = £1249.00 
180Mb £2065.00 135Mb  £1625.00 
Card only£199.00 170Mb  £1850.00 
A3000 Card £199.00 330Mb £2845.00 


BBC Winchesters available from £359.00 
p&p £15.00 winchesters, £8.00 card only 


- OAIX » 


Oak Computers, Cross Park House, 
Low Green, Rawdon, Leeds LS19 6HA 
Tel: 0532 502615 Fax: 0532 506868 
Also available from all good Acorn Dealers 


Worra Plotter 


HPGL plotter driver 
to allow Drawfiles to be 


4 plotted to HPGL plotters. 
Output may be scaled and 


sent to ports, network or vt | @) 


All prices exclude VAT 


£29.95 (p&p £4.50) 


PDT 


Parametric 
Design Tool. 
Professional 
Computer 
Aided Design. 2D parametric design and 
modelling system allows designs to be 
tested, animated and easily modified 
before being output to an HPGL compatible 
plotter or via DXF files to other CAD 
systems or !Draw and then on to DTP etc. 


£359.00 p&p £6.00 


TAPE 
STREAMERS 


Available from mid-December, Oak SCSI 
Tape Streamers provide the ideal means 
of backing up data from SCSI or ST506 
winchesters, networks or indeed any filing 
system. Desktop software allows files for 
backing up to be easily specified, and 
data can be saved and restored ona file 
by file basis. Add £100 if you do not have 
a SCSI card. p&p £15.00 
60Mb (per tape) £999.95 
150Mb (per tape) £1254.00 


Worra Battle 


Classic Tank Battle 
Game, Voted best 
game at the Personal 
Computer Show by the Guardian. 3D 


cc @] high speed vector graphics. 


£14.95 (p&p £4.50) 


The Qume Crystalprint Publisher 


prints out a neat display of the full 
character set of the 39 typefaces. 


Times (Trinity) 
Helvetica (Homerton) 
Courier (Corpus) 


LwuPor (Symbol) 
Avant Garde 


Bookman 

New Century Schoolbook 
New Helvetica Narrow 
Palatino 

Zapf Chancery 


Figure 3. The Publisher Comes with 
11 resident font tamiiles 


CONSUMABLES 

Access to the inside of the Publisher 
is easily achieved by lifting the lid of the 
machine, which hinges from the back. 
This reveals two cartridges housing 
consumables: the toner cartridge system 
and the drum. Each toner kit contains a 
toner mechanism with hopper, inking 
rollers etc. and 3 toner cartridges, plus 
sundry items like toner collecting 
bottles. Once all three cartridges have 
been used, the toner mechanism is 
replaced in its entirety from a new toner 
kit. The whole kit costs around £80 inc. 
VAT, and is good for 6000 copies at 5% 
average paper coverage. The drum unit 
lasts for some 20,000 copies, and costs 
around £100 ine. VAT. This gives a cost 
of less than 2p per page including VAT, 
but not including the cost of the paper. 
This compares very favourably with 
other laser printers. The Apple 
LaserWriter works out at around 3p per 
page, while the KX-P4450 is more than 
double, at over 4p per page. 


CONCLUSION 

The Qume Crystalprint Publisher 
represents an excellent buy when 
compared with other PostScript page 
printers, and has achieved consistently 
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good reviews in a range of business 
computing publications. It is exceedingly 
fast (around twice as fast as the more 
expensive Apple LaserWriter), and 
produces a high quality printout. 


When compared to the range of cheaper 
LaserJet compatible printers it also fares 
extremely well. For DTP work its output 
speed is staggeringly faster than the best 
LaserJet compatibles. Its Casio engine, 
rated at 6 pages per minute, seems well 
constructed, if a little noisy. Of course this 
printer is considerably more expensive 
than some of the cheaper LaserJet 
compatibles. But there are often hidden 
extras with these. The KX-P4450 comes 
with only half a megabyte of RAM for 
example (with a 1 Mbyte upgrade costing 
£340 inc. VAT) compared to the 3 Mbytes 
supplied as standard with the Publisher. 


If you are looking for a PostScript page 
printer, the Publisher must be a very 
strong contender, though it may well be 
worth waiting a month or two for the 
release of the new version of this printer 
which will have an additional LaserJet 
emulation mode. It may also be well worth 
considering the LaserJet compatible 
Crystalprint WP+ with a view to 
upgrading to the Publisher at a later date. 


Availability: 

Both printers are available from BEEBUG 
on (0727) 40303. 

The Crystalprint WP+ costs £964.49 inc 
VAT: 

The Crystalprint Publisher costs £2775.93 
ine. VAT. 

The toner kit costs £58.00 inc. VAT. 

The recommended retail prices of these two 
printers are £945.00 and £2999.00 ex. VAT. 


Firmware upgrade: 

If you already have a Crystalprint 
Publisher with firmware version less than 
3.03, and it is still within its one year 
warranty period, you can obtain details of 
Qume’s free upgrade from Jan Nelson on 
(0734) 584646. AU 
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Assembler Workshop 


David Spencer delves further into the ARM processor with a look at 


its various operating modes. 


n this month's Assembler Workshop we 
take a look at the subject of processor 
modes. Like the use of register R15 which 
was covered in last month's article, this 
topic is often omitted from an introductory 
study of the ARM processor, in order to 
avoid confusion. However, it is a topic 
which must be understood if the processor 
is to be used to its full potential. 


WHAT ARE PROCESSOR MODES? 


A good starting point is to explain 
what the different processor modes are. 
There are four different modes, the one in 
use being determined by the type of code 
the processor is executing. The current 
mode is indicated by the bottom two bits 
of register R15, as shown below: 


Mode Bit 1 BitO 
USR 0 0 
FIQ 0 1 
IRQ | 0 
SVC 1 1 


USR mode is the most common. The 
name stands for User, and as it suggests, 
this mode is used for the user's programs. 
Indeed, all applications, such as Basic and 
the C compiler, run in USR mode, as do 
assembly language programs CALLed 
from Basic, and ‘user created’ applications 
such as compiled code. USR mode is also 
used for transient utilities. These are files 
with filetype &FFC (Utility) that are 
loaded into the relocatable module area 
when needed, and discarded afterwards. 
More details of utilities were given in 
RISC User Volume 2 Issue 6. 


FIQ and IRQ mode are used by the 
processor when executing the code that 
handles Fast Interrupt Requests and 
ordinary Interrupt Requests. These were 
discussed in the Under the Lid series in 
RISC User Volume 3 Issue 3. 


The final mode, SVC mode, is used by 
the ARM whenever it is executing 
operating system-type code, for example 
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the execution of a SWI call. The 
programmer is most likely to encounter 
SVC mode when writing modules, as most 
of the entry points are called in SVC 
mode. 


IRQ, FIQ and SVC modes are 
collectively known as the supervisor 
modes as they are used while the 
processor is executing code forming part of 
the operating system, which can be 
thought of as a system supervisor. 


WHY HAVE DIFFERENT MODES? 


You may at this stage wonder why the 
processor needs to have different 
operating modes at all. Basically, the aim 
is to isolate as much as possible different 
parts of the system. For example, the 
interrupt handling part of the operating 
system must be implemented in such a 
way as to be totally transparent to the 
user's program. Conversely, the user's 
program shouldn't interfere with the vital 
functions of the operating system, 
however much of a mess it gets into. 
Having different processor modes helps to 
achieve our aim in two ways - memory 
protection and register allocation. 


We will look at register allocation first. 
At all times, the program being executed 
‘sees’ fifteen registers - RO to R15. Of 
these, R15 is dedicated to the Program 
Counter (PC) and Processor Status 
Register (PSR), R14 is reserved for use as 
a link register, and R13 is conventionally 
used as a stack pointer. However, the 
ARM processor in fact contains twenty- 
seven registers as shown in figure 1. You 
will see that certain register numbers (for 
example R13) map to more than one 
actual register. In this case, the register 
used depends on the mode. 


Each mode has its own R13 and R14, 
meaning that each mode can keep its own 
stack (as each has its own stack pointer), 
and calls made when the processor is in 
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one mode will not affect the link register 
of any other mode. Additionally, FIQ mode 
has five private registers. These allow a 
fast response to Fast Interrupt Requests, 
as it is not necessary to stack the user's 
registers first. 


User mode | SVC mode 


R13. | Ridsve | Ri3_imq | RId_fiq 


R14 | Ri4_sve | Ri4 irq | Ri44Hiq 
R1S(PC/PSR) 


Figure 1. The ARM register layout 


Normally, you refer to register names 
such as R13 with the assumption that it 
will be the R13 appropriate to the 
particular mode. However, if you need to 
specify a particular register, then it is 
suffixed with the mode name; for example 
R13_IRQ or R14_SVC. 


MEMORY PROTECTION 

One of the most important uses of 
processor modes is to provide memory 
protection. The memory map of the 
Archimedes is split into ROM, physical 
RAM, IO devices and logically mapped 
RAM. This was covered in part two of the 
series Under the Lid in RISC User Volume 
3 Issue 1. When in one of the supervisor 
modes, the processor can freely access any 
part of the memory map. However, in USR 
mode access is denied to the physical RAM 
and IO devices, and access to the logical 
RAM can be controlled on a page-by-page 
basis to be denied totally, read only, or 
read/write. This ‘protects’ the system 


from misbehaved applications accessing 
areas they shouldn't, and so causing 
havoc. For instance, RISC OS protects the 
area of RAM used for the RAM disc, to 
prevent it being accidentally corrupted. 


CHANGING MODES 

Changing from one processor mode to 
another can be performed either 
implicitly, by the processor itself, or 
explicitly from software. 


Implicit changes occur when an 
exception is detected by the processor. An 
exception is any event which is not 
expected, such as an access to an illegal 
address, or an interrupt. Table 1 lists the 
various exceptions, together with the 
mode that the processor enters when the 
exception occurs. In all cases, the return 
link back to the main program is saved in 
the R14 of the mode entered by the 
exception. More details of exceptions can 
be found on pages 85 to 90 of the 
Programmer's Reference Manual. 


Exception 
Reset 
Undefined Instruction 
SWI Executed 
Prefetch Abort 


Data Abort 
Address Exception 
IRQ Received 

FIQ Received 


Table 1. Processor exceptions 


Explicit mode changes are normally 
used to change back to a specific mode 
after a previous implicit change. In 
particular, remember that when an 
exception is processed, the return link 
stored in register R14 contains, in bits 0 
and 1, the processor mode prior to the 
exception occurring. If the routine that 
handles the exception exits using the 
instruction: 


MOVS PC,R14 
or, if the return link has been stacked: 
LDMFD R13!, (PC}* 


then the mode bits will be restored along 
with the interrupt state and other flags at 
the same time as the return is performed. 
Note in this case that the ‘S’ in the 
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instruction (or the '*') is absolutely 
essential, otherwise the return will be 
made, but the processor will be left in the 
wrong mode and with the wrong interrupt 
state, and the flags will have been corrupted. 


When a mode change is not linked to a 
‘return’ operation, the best course of 
action is to use the TEQP instruction. 
This was covered in last month's 
Assembler Workshop, but we will recap 
here. Basically, an instruction of the form: 

TEQP Rn, #value 
Exclusive ORs the constant with the 
contents of the specified register, and then 
writes the bits of the result directly into 
the PSR flags. For example, bit 29 of the 
result is written into bit 29 of the PSR, 
which is the carry flag, and more 
importantly, bits 0 and 1 are written 
directly into the mode bits, thereby 
changing the processor mode, The TEQP 
instruction doesn't alter the program 
counter at all, and hence execution 
continues normally, 


If you want to change just the mode 
without affecting any of the other flags, 
you can use the sequence: 

MOV RO, PC 

TEQP RO, #(oldmode EOR newmode) 
Normally you will know what the current 
mode is, although you can always find it 
out by looking at the mode bits. If the 
state of the flags doesn't matter, then the 
single instruction: 

TEQP PC, #newmode 
can be used. This will however clear all the 
flags, and hence re-enable both IRQs and F1Qs. 


Whichever form of the TEQP 
instruction is used, it must be 
immediately followed by a ‘no operation’ 
instruction to allow the processor to sort 
itself out before execution continues. The 
instruction conventionally used is: 

MOVNV RO, RO 

One point worth remembering when 
changing modes is that the mode bits of 
the PSR cannot be changed when in USR 
mode. This means that, for example, you 
could not change from SVC to USR mode 
and back again. 
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With this in mind, you might ask "How 
do you change into SVC mode from USR?”. 
This can be done using the SWI call 
"OS_EnterOS". As with all SWI calls, SVC 
mode is entered automatically. However, 
the call then alters the return link so that 
the processor is left in SVC mode when 
the call returns, If you wish to enter IRQ 
or FIQ mode, then you will have to first 
enter SVC mode, and then use a TEQP 
instruction to change to the desired mode. 
This call should be used with caution, as 
the Basic interpreter (in common with 
most other applications) can only run in 
USR mode. Therefore, if you execute this 
call from the command line, or within a 
program, the entire computer will hang. 
This means that you should only change 
mode within your own machine code 
routines, and you must change back to 
SVC before returning to Basic. 


CARE WITH REGISTERS 

The reason that many applications 
will not run in SVC mode is that extra 
care is needed with register usage. 
Consider the following simple subroutine 
to print the letter ‘A’: 


MOV RO, #ASC"A" 
SHI "OS WriteC" 
MOVS PC, R14 


If the processor is in USR mode this will 
behave perfectly, because when the SWI 
call is executed the return link is stored in 
R14-SVC, leaving the contents of R14- 
USR untouched. However, if the routine is 
executed in SVC mode, then R14_SVC will 
be set to the return link from the 
subroutine. The SWI call will corrupt this, 
and when the final instruction is executed 
the return address will have been lost and 
a crash results. Hence, whenever SVC 
mode is used, R14 should be stacked 
before any SWI calls are made. 


The situation in FIQ and IRQ modes is 
even more involved, because interrupts can 
occur totally asynchronously. For example, 
interrupts must not be re-enabled before 
R14 has been stacked, otherwise a new 
interrupt would overwrite its contents, But, 
explaining interrupt handling needs a 
series in its own right to cover it fully. =») 
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As the leaders in software for the Archimedes range of computers, CLARES | 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


lf you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


lf you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value fo its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D, Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


by Mike Williams 


I n a previous article (RISC User Volume 3 
Issue 2) I described the rudiments of the 
Arc’s sound system. To recap briefly, 
different types of sound (or instrument) 
are called voices, and ten default voices 
are built into RISC OS. Other voices can 
be added. Up to eight voices may be in use 
at any one time by assigning a voice to a 
channel. Once such an assignment has 
been made, the voice or instrument can be 
‘played’ by executing a SOUND statement. 
This determines the pitch, volume and 
duration of the resulting note. See the 
chapter on sound in the Basic User Guide. 


What I didn’t cover, and what you may 
have wondered about then, is how to 
combine and synchronise a sequence of 
notes to produce music. For example, if 
you have tried the Maestro application 
from Applications Disc 2, and played any 
of the tunes supplied, then you will be 
well aware that notes are played ata 
regular tempo, and that more than one 
note can be sounded at the same time. 
How can this be achieved? 


That is what I want to deal with now. 
However, the purpose of this article is not 
to show you how to compose and play 
music of the complexity of that supplied 
with Maestro. You already have that 
application and unless you are a 
reasonably competent programmer, using 
Maestro is by far the best way to 
experiment. However, that won't give you 
any understanding of how the playing of a 
sequence of notes can be achieved. That’s 
what we shall be looking at here. If you 
want to try things out as we go along, 
then you will need to exit from the 
Desktop (by pressing Ctrl-Shift-F12) and 
then select Basic by typing: 

BASIC <return> 
before you start. 


In principle, we can specify the 
number of beats per bar of music and the 
rate at which the beats occur (the tempo). 
An extra parameter with the SOUND 
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command then allows us to specify on 
which beat in the bar a note is to start. 
Provided they use different channels, 
several notes can be sounded together by 
specifying that they all start on the same 
beat. It all sounds quite obvious really, but 
putting it into practice can be more 
taxing. 


CONTROLLING THE BEAT 
The first new keyword which we need 
to use is BEATS. If we write (or type): 
BEATS 64 
then we have specified 64 computer beats 
to a bar (or cycle). This causes the so- 
called beat counter to repeatedly count 
from zero up to 63 (1 less than the value 
specified by BEATS). Let’s look at a simple 
example of this in operation. Consider the 
following program: 


100 BEATS 64 

110 *ChannelVoice 1 2 
120 REPEAT UNTIL BEAT=0 
130 SOUND 1,-15,41,5,8 
140 SOUND 1,-15,41,5,16 
150 SOUND 1,-15,41,5,20 
160 SOUND 1,~-15,41,5,24 
170 SOUND 1,~-15,41,5,32 
180 SOUND 1,-15,41,5,52 
190 SOUND 1,~-15, 41,5, 60 


If you type this in and then run it, you 
should recognise the rhythm it produces 
(but don’t expect a musical masterpiece). 
Line 100 sets the number of beats per bar 
at 64. The next line assigns voice 2 
(StringLib-Soft) to channel 1 (but it could 
be any voice, and any channel). Line 120 
is important. Once the BEATS statement 
has been executed, you can imagine the 
beats ticking away just like the swing of a 
metronome. Line 120 makes the program 
wait until the beat counter is at the start 
of its cycle (beat 0). Note that the similar 
but quite separate keyword BEAT 
provides the current value of the beat 
counter. The BEATS command specifies 
the number of beats which the beat 
counter counts per cycle. 
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The seven SOUND statements which 
follow are all similar except for one 
parameter, the fifth. This is the additional 
parameter referred to before, and specifies 
the number of beats after which the note 
will be sounded. Thus the note specified 
by line 130 will be sounded after 8 beats, 
that of line 140 after 16 beats and so on. 
All the beats are counted from the start of 
the beat counter cycle (i.e. from zero). 


The other values in the SOUND 
statements used above follow the format 
described in the previous article. The first 
value (1) specifies the channel, the second 
(-15) the volume (here given at its 
maximum), the third is the pitch (41 is ‘A’ 
on the musical scale - see the Basic User 
Guide for a complete table), while the 
fourth parameter (5) is the duration of the 
note (in this case 5 twentieths equivalent 
to a quarter of a second). Of course, if the 
duration of any one note were long 
enough, it could overlap the sounding of 
the next note in the sequence, but only if 
this were on a different channel. 


If we want two separate notes to be 
sounded each time, then we will need first 
of all to assign a voice to a second channel, 
and it might as well be a different voice, 
so we will use StringLib-Steel (voice 
number 4). Remember that you can check 
on the available voices by typing in the 
command: 

*VOICES 
at any time. If you have the magazine disc 
that went with Volume 3 Issue 2, then you 
can also use any of the additional voices 
supplied on that disc. So add to the 
original program the line: 

115 *ChannelVoice 2 4 
to assign our choice of a second voice to 
channel 2. 


If you want to ensure that a second note 
is sounded at the same time as another, 
then rather than specifying the same 
number of beats (which you could try) you 
just put -1 as the after parameter in the 
SOUND command. So now add the 
following two lines to our example program: 

185 SOUND 2,-15,25,5,-1 

195 SOUND 2,-15,25,5,-1 


The last two beats of the rhythm played 
by our program now consist each of double 
notes, one at A on the musical scale and 
one at F (pitch 25), played by two different 
instruments or voices. You could similarly 
double up each of the other beats to two 
notes. 


You should now begin to understand 
how notes can be sequenced relative to one 
another in time, and indeed how more than 
one note, on different channels, can be 
sounded at the same time. To play a tune of 
some kind we would need to repeat all the 
beats comprising a single bar of music until 
all the notes have been played. At its 
simplest, we could continually repeat our 
sequence of seven notes in our short demo 
program by adding the two lines: 

118 REPEAT 

200 UNTIL FALSE 


In general, the details of the notes 
themselves (i.e. the parameters required 
in the SOUND statements) could be 
supplied in the form of a series of DATA 
statements, or indeed (as with the 
Maestro application) read in from a file. 


SETTING THE TEMPO 

One aspect of musical composition we 
have not yet considered, though, is how to 
control the speed or tempo of a sequence of 
sounds. To do this we need to use a further 
keyword, not surprisingly called TEMPO. 
This determines the rate at which the 
beat counter marks time. In the example 
which we used to experiment with above, 
no tempo was specified and the default 
value of &1000 was used. This is a 
hexadecimal number and corresponds to 
one beat per centi-second. As a result 
there are 100 beats per second. The 
example specified a BEATS value of 64, 
that is 64 beats per ‘bar’. Thus each bar or 
cycle of sound will last 64/100 seconds, 
less than one second. We were fortunate 
that the default tempo in conjunction 
with a BEATS value of 64 suited our 
requirements reasonably well. 


Because the tempo is measured in 


centi-seconds it can often be more 
convenient to work in tens and hundreds 
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when controlling sound. Here is another 
short example program: 


100 BEATS 400 

110 *ChannelVoice 1 2 
120 TEMPO &E00 

130 REPEAT 

140 REPEAT UNTIL BEAT=0 
150 SOUND 1,-15,21,5,20 
160 SOUND 1,-15, 21,5, 40 
170 SOUND 1,-15,21,5,60 
180 SOUND 1,-15,5,10,80 
190 UNTIL FALSE 

200 END 


The beat counter is set (line 100) to 
count 400 beats to a bar. The subsequent 
SOUND statements cause appropriate 
notes to sound after 20, 40, 60 and 80 beats. 
The pitch of the notes used, 21 and 5, 
correspond to ‘E’ and ‘C’. The tempo of 
&E00 was selected from trial and error as 
giving the most pleasing rate of playback. 
The REPEAT-UNTIL loop (lines 130 and 
190) causes the four note sequence to be 
repeated indefinitely. After the fourth note 
has been sounded on beat 80, no more notes 
are sounded until the beat counter has 
reached 400, started again and reached 20. 
This provides a period of silence between 
repetitions. Lastly, we have used voice 2 
(StringLib-Soft). Note that the TEMPO 
keyword can also be used as a pseudo 
variable to return the current tempo. 


The tempo can be specified as either a 
decimal or hexadecimal number. 
Increasing its value will increase the 
tempo (beats per centi-second); lowering 
its value will decrease the tempo. A value 
of &2000 hexadecimal (8192 decimal) will 
double the default tempo, a value of &800 
(2048 decimal) will halve it (if you are 
unfamiliar with the hexadecimal number 
system, a brief explanation is given on 
page 27 of the Basic User Guide), and you 
can always use decimal if you prefer. 


FURTHER ADVICE 

We have already seen the use of a loop 
to find the start of a beat counter cycle 
(BEAT=0). In practice, if a program is 
controlling other tasks as well as sound 
within the same loop (updating the screen 


to check precisely when the beat counter 
is equal to zero. It is better to select some 
inequality such as: 

REPEAT UNTIL BEAT<10 
and use this as the start of a cycle. 


Furthermore, it may also be necessary 
to have a second synchronising REPEAT- 
UNTIL loop after the SOUND statements 
of the form: 

REPEAT UNTIL BEAT<>0 
This could be included as line 199 in our 
first example, and as line 189 in our last 
example. This prevents the possibility of 
the same sounds being scheduled twice in 
the same bar. 


SAMPLE TUNES 

As I said before, at the beginning of 
this article, the intention is not to describe 
how to program complex music, but to give 
some insight into how the Archimedes’ 
sound system works, and how it can be 
simply controlled from within Basic. If you 
have tried my examples and followed what 
I have described you should be able to 
incorporate simple sounds into any 
programs which you write yourself. There 
are also some more advanced features of 
the sound system, described in the Basic 
User Guide and elsewhere, which give 
greater control over some of the features. 


If you want to achieve something 
rather more musical and pleasing, then I 
suggest that the Maestro application 
already mentioned is the best vehicle for 
doing this. To add to the repertoire of 
tunes provided by Acorn with this 
application we are including two further 
tunes on this month’s magazine disc. Both 
are works by Bach (thus avoiding any 
copyright problems that might arise with 
living composers). We are also including a 
program, from RISC User Volume 1 Issue 
9, which will quickly and simply replay 
any tune created by Maestro. 


If you can add further to the repertoire of 
music for the Archimedes, then we would 
like to hear from you with a view to 
including further musical compositions 
from time to time on the disc, but be aware 
of my comments on copyright above. =) 
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ARCHIMEDES SOFTWARE 


HOME ACCOUNTS; ANCESTRY 
£49.95 £79.95 


Keep your home or club finances in order.| The ultimate in computerised genealogy! 
Full control of multiple bank accounts for use in families or pedigree animals. 
including credit cards and building Use added card index for extra data or 
societies. Budgeting facility to assist photos of individuals. Demo file 
cashflow prediction. Graphs of contains illustrated Royal Family 
budgets and expenditure. Caters tree. Vertical or horizontal 
for standing orders, transfers, ATEL| EQ printout of family tree. 
statement reconciliation, etc. For home, hobby or 


(Multi-tasking if using educational use. 
RISC OS.) £99.95 (RISC OS compatible) 
& 0392-42756 ® 


Prices Access & 
inclusive Professional quality art package. Probably the most Barclaycard 
of VAT sophisticated sprite editor available. Animation of image accepted 

sequences with Quantel-style graphic effects. Anti-alias 

squashing, rotation of areas into any quadrangle, and sprite and 
brush patterning. Further features allow TV-style techniques to 
even wrap a picture around a 3D surface. 
(Multi-tasking if using RISC OS.) (To be released soon). 


Gy ZINA NERA AN 


69 SIDWELL STREET, EXETER. EX4 6PH Tel: (0392) 437756 Fax: (0392) 421762 


by Lee Calcraft 


The Archimedes 
serial RS423 port has 
many uses: from 
printer connections to 
comms. And as with 
all serial interfaces it 
must be set to exactly 
the right send and receive baud rate (i.e. 
speed), and the number of data bits, stop 
bits and the parity must be correctly set 
before communication with any external 
device can be established. 


By generating a comprehensive status 
display, the procedure listed here provides 
a very simple way to check that all the 
options are correctly set up. To make use 
of it, type in the program and run it. It 
should give a display something like that 
in the accompanying illustration. If you 
want to include the procedure in a 
program of your own, just append the 
code, and call PROCportstatus to give the 
display. Alternatively you can use 
INSTALL or LIBRARY to enable you to 
call the procedure when another program 
is resident in memory (for further details 
see Using Basic Libraries, RISC User 
Volume 1 Issue 2 page 29). 


10 REM >PortInfo3 
20 REM Program 

30 REM Version A 0.03 

40 REM Author Lee Calcraft 

50 REM RISC User March 1990 

60 REM Program Subject to Copyright 


Transni 


Serial Port Info 


80 PRINT'"Serial port information:" 
90 PROCportstatus 
100 END 


120 DEFPROCport status 

130 LOCAL rate’, p% 

140 SYS "OS SerialOp",6,-1 TO, rate% 
150 anst=FNgetbrate (rate%) 

160 PRINT "Transmit at ";ans%;" baud, 


170 SYS "OS_SerialOp",5,-1 TO, rates 
180 anst=FNgetbrate (rate%) 

190 PRINT "receive at ";anst;" baud." 
200 Sys "OS _Serial0p", 1,-1 10,p% 

210 bitst=8-(p% AND 3) 

220 PRINT ;bits%;" bits, "; 
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A Serial Port Status Utility —— 


Serial iy! information: 


n at 4986 baud, receive at 4808 baud. 
? bits, 1 stop bit(s), parity enabled, even parity, 


230 p%=p%>>>2:stopt=p% AND 1 

240 p%=p%>>>1:vt=pt AND 1 

250 CASE TRUE OF 

260 WHEN stopt=0:truestop=1 

270 WHEN stopt=1 AND bits%=8 AND v= 
O:truestop=1 
280 WHEN stop%=1 AND bits%=5 AND vt= 
itruestop=1.5 
290 OTHERWISE truestop=2 
300 ENDCASE 
310 PRINT ;truestop;" stop bit(s), "; 
320 PRINT"parity "; 
330 IF vt=0 THEN PRINT "disabled, "; E 
LSE PRINT “enabled, "; 

340 pt=p3>>>1:vs=p% AND 3 

350 CASE v% OF 

360 WHEN 0:PRINT "odd parity." 

370 WHEN 1:PRINT "even parity." 

380 WHEN 2:PRINT "parity 1 on TX, ig 
nored on RX." 

390 WHEN 3:PRINT "parity 0 on TX, ig 
nored on RX." 

400 ENDCASE 
410 ENDPROC 


ray 


430 DEFFNgetbrate (rate%) 

440 it=-1:PROCrestore("baudrates") 

450 REPEAT 

460 it+=1:READ ans% 

470 UNTIL it=rate$ OR ans¢=-1 

480 IF anst=-1 THEN ERROR 254,"Baud ra 
te number too large for table" 

490 =ans3 

500 : 

510 DEFPROCrestore (label$) 

520 RESTORE 

530 REPEAT 

540 READ A$ 

550 UNTIL A$=label$ 

560 ENDPROC 

570 : 

580 DATA baudrates 

590 DATA 9600, 75,150, 300,1200, 2400 

600 DATA 4800, 9600,19200,50,110,134.5 

610 DATA 600,1800,3600,7200,-1 AU 


41 


Reading up on DTP 


Two books reviewed by Mike Williams 
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DTP AT A GLANCE 
by Rob Pickering, published by Bookmark Publishing at £9.95. 


This comparatively slim 90 page book is 
both an informative and an interesting read. 
Its declared aim is to introduce the basic 
terms and concepts that the newcomer to 
desktop publishing (DTP) is likely to 
encounter, and as such makes a useful 
companion to any DTP manual (in fact 
Computer Concepts are including it with 
each copy of their DTP package Impression. 


The book is divided into three sections. 
The first on typography is concerned with 
fonts and typefaces, measurements (in 
terms of points, picas etc.), and line and 
letter spacing. The book covers the history 
and derivation of traditional terms which 
are still used in today’s electronic world. All 
this is very useful, but some guidance on 
which typefaces are most suited to different 
functions (headlines, section headings, body 
text and the like) would have been quite 
useful for the newcomer. 


The second section deals with page 
design and layout, the use of margins and 
gutters, and the positioning of larger type 
objects. These chapters feel less precise, but 
then good design cannot always be 
expressed in quantitative terms. One 
omission I feel here is guidance on the 


This book is much more specific in that 
it is exclusively concerned with the use of 
Acorn DTP, Acorn’s DTP package for the 
Archimedes. A point to stress at the outset 
is that although it describes itself as ‘An 
Advanced User Guide’, a better title would 
surely have been ‘The Acorn DTP 
Companion’ because that is what the book 
is, a readable and informative companion to 
every aspect of Acorn DTP, from the most 
simple and elementary get-you-started ideas 
to many more advanced features. 


The book begins most commendably by 
detailing how to configure your Archimedes 


incorporation of graphics or illustrations 
into the page layout. 


The final section of this book is 
concerned to present an overview of 
production and printing methods that are 
appropriate to small print runs. This is an 
informative though rather lightweight 
section, as most of the information could be 
obtained by talking to your local printer. 
Again some information is missing such as a 
discussion of different paper characteristics 
(the difference between coated and non- 
coated papers for example), and any 
explanation of paper weights and their 
implications for printing. 


In conclusion, this is an easy and 
informative book to read, but most of the detail 
which it contains can be assimilated in a 
comparatively short time, after which I suspect 
most readers will have learnt all they need to 
know. From then on using DTP in earnest is 
the best teacher, coupled with a measure of 
common sense and an an eye for good design. 


This would make an _ excellent 
introduction to DTP, if included (as CC has 
done) with any major DTP software, but 
rather lightweight at £9.95 considered on its 
own, None the less, recommended. 


ACORN DTP: AN ADVANCED USER GUIDE 
by Anne Rooney, published by Emerald Publishing at £14.95. 


to get the best out of DTP, a subject of 
particular interest to owners of 1 MByte 
machines. There follows a short chapter on 
some of the principles of DTP (all based on 
Acorn DTP of course), and then a 
substantial and detailed section about page 
formats, master pages and style sheets. 
Mastery of these features is crucial to good 
DTP work. However, the book uses a quite 
small point size and a comparatively dense 
format for each page requiring careful 
reading if all the detail is to be assimilated. 


The book continues with two short 
chapters on the techniques involved in 
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importing text and graphics, followed by a 
chapter Working with text which starts by 
describing the typing and importing of text. 
The apparent overlap with the previous 
chapters is a mite confusing, though there is 
no real overlap in content. These sections 
are again full of information, and will repay 
careful reading, though one might have 
wished for more visual examples. 


The next, substantial, chapter entitled 
Documents and projects will I am sure prove 
invaluable to many users of Acorn DTP. 
This section looks at a range of different 
requirements that a user might have, and 
discusses how these might be met with 
Acorn DTP. This is very much the kind of 
advice and guidance that is understandably 
missing from Acorn’s own manual. There is 
a similarly informative chapter on style and 
layout, and another on the more specialised 
typographic effects that can be produced. 


A number of further shorter chapters, in- 
cluding one on solving problems which users 
might encounter, complete this 200 page book. 
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Overall, I have to say that I was much 
more impressed with this book than I 
expected to be, although it must be 
emphasized that the amount of detail does 
not make for light reading, in direct contrast 
to the first book reviewed here. In my view, 
the book is still a little overpriced (£12.95 
would be nearer the mark), but nevertheless 
it provides invaluable help for all users of 
Acorn DTP. What more can you ask for? 
Well, there is also an examples disc for just 
£3.95 inclusive, though I have not had the 
opportunity to assess this. 


If you are buying Acorn DTP and intend 
to use it to the full then I suggest you buy 
this book from the outset. You won't be 
disappointed. 


Note: Both books reviewed here (and the disc 
mentioned) are available direct from 
BEEBUG retail. As a special offer to RISC 
User readers, we will include the examples 
disc free of charge with each copy of the 
Acorn DTP book ordered. Bey 


1 EMACS. Super editor with language. Now includes full C source, 
2 MicroSpell. 43,000 word real time spelling checker module. 
4 XLISP. Object oriented version of LISP with C source and progs. 
5 C Toolkit. 20+progs for C programmers with sources. grep, awk,.. 
6 Kermit. Archimedes, BBC and MSDOS versions of comms. prog. 
7 WIMP Chess. Good wimp based chess game with many features. 
8 CrossStar. wimp based crossword solver with huge dictionary. 
Disc 10 More C Tools. yacc and lex with examples and C source. diff etc. 
Disc 11 Little SmallTalk. original object oriented language with C source. 
Disc 14 GNU Tools#1. high quality tools with source. egrep,sed,awk, diff. 
Disc 15 Clip Art#1 50 pictures, also 65 Epson LQ printer fonts, !Sparkplug 
Disc 16 Spark. Super RISC OS wimp based multitasking file/directory 
archiver. !Backdrop sticky desktop, pd progs, 1Mb. colour pics. 
Disc 18 MTV Raytracer. database driven 3D raytracing package with C 
source code. Lots of fun making pretty raytraced pictures. 
Disc 19 Starchart. wimp multitask program to make Draw file starmaps 
showing positions of stars and planets. Catalog of 9000 stars. 
Disc 20 GNU Tools#2. gnumake. CXRF C source code cross ref. dbase. 
Xfmt simple nroff, pr formatter, M4 macro language. with C srcs. 


Each disc is £5.99 inc. Buy four claim another free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail Gelivery on overseas orders. 


Full list available on request. 


1st Word PIusS (Release 2) 


Mark Sealey reports on the latest version of this word processor 


from Acorn. 


INTRODUCTION 


In RISC User Volume 2 Issue 8 I took a 
critical look at Acorn’s 1st Word Plus word 
processor (with its origins on the Atari 
ST), and the ways in which this might be 
enhanced. The point then made was that 
the original package contained many 
faults, only some of which could be 
circumvented (or overlooked) by users of 
that version. These included unpredictable 
formatting, hard-to-use disc management, 
and the absence of some quite basic 
functions associated with text editing. 


Now an updated version is available. 
Although the bugs which jinx formatting 
have not been eliminated (text will still 
occasionally jump unpredictably into a 
block at the right-hand side of the page or 
screen), some of the other snags and 
omissions have gone. 


Acorn - strangely - never intended this 
latest release to be a complete rewrite, 
though this would surely have been in 
everyone’s interest, as competition from 
other word processors is still relatively 
weak. lst Word Plus release 2 is well 
worth considering for anyone who has not 
plumped for Pipedream road or who wants 
more than View under the 6502 emulator. 


OVERALL CHANGES 

1st Word Plus now works completely 
within the RISC OS Desktop. That means 
that there are multiple scalable windows, 
including ones to handle multiple texts. 
Loading, saving and printing are now 
achieved by dragging a file icon, not by 
stepping up and down the ADFS trees. No 
backup text is created automatically, and 
users are given just as much freedom to 
customize and distribute text and data 
files on a disc as they wish. 


One or two start-up options (such as 
the check before overwriting files and one 
to cope with plain text files) can also be 
changed by amending the appropriate 
lines (using Edit) of the main 1st Word 


Plus !Run file, though this is not the most 
user-friendly nor fool-proof approach. 


Instead of having the function keys 
and associated information displayed 
permanently at the foot of the screen 
(which itself uses a less garish palette), 
the ‘keypad’ is considered as an 
autonomous and separately controlled 
window. This can be hidden behind the 
current document until required (chiefly 
for printing, assuming you know all the 
function key effects) and then invoked; the 
feeling is nevertheless odd and a little 
inelegant. However enthusiastic about the 
Wimp you might be, you will hardly want 
to fragment the business of composing and 
changing text. 1st Word Plus’ new attempt 
at the compromise is only one of many 
possible solutions. If you DO like the Acorn 
Wimp, it works; if you do not, it might turn 
out to be something of a nuisance. 


INTERFACE WITH THE MACHINE 
Because 1st Word Plus now runs from 
the Desktop, F12 allows Operating System 
(star) commands. These, together with 
some hints on the best use and restrictions 
on memory, now feature in the manual. 
Earlier limitations when handling large 
documents (loss of text and pagination etc) 
appear now to have been overcome. 
Although it would have to be a very large 
document to fill even an unexpanded 1 Mbyte 
machine, you do get some warning when 
memory is running out, and disappearing 
drafts should be a thing of the past. 


EDITING 

Earlier difficulties with one set of 
these F-key operations (to italicise, 
embolden and _ underline) have 
disappeared, and this now works smoothly 
and as expected. Acorn appears to have 
incorporated suggestions made to them in 
response to an earlier version of this 
release 2, and one or two bugs linked to 
these commands have been ironed out. 
Incidentally, the menu to handle them has 
now been changed and is called “Select”. 


eee—— eC 
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There is now a case swap (Ctrl-V), and 
cursor key combinations allow immediate 
jumping to top and bottom of text. Other 
keystroke equivalents are explained in ten 
pages of the manual for those who find 
this easier than using the mouse. 


DOCUMENTATION 


The new manual is even better than 
before. The rewritten 150 page book 
contains a tutorial as well as sections on 
each of the menus in turn. It is in the new, 
standard, Acorn format with a wide left 
margin containing headings and sub- 
headings, and is very easy to use. But the 
index is unfortunately not so good. 


Text layout and formatting facilities 
are explained much more in terms of the 
desired effect rather than by what each 
keypress does; and there is also a section 
on preparing text for output to Acorn 
DTP. 


SPELLING AND PRINTERS 


The dictionary has been extended - to 
70,000 words. The operation of the 
spelling checker is perhaps rather 
sparsely dealt with in the manual, but is 
as impressive as it always was. 


There is now a 1st Convert directory to 
simplify the whole process of creating and 
compiling 1st Word Plus’ printer drivers 
(not the RISC OS ones), though the 
manual is strangely unforthcoming on 
this. In fact, the business of getting your 
printer to live up to the most sophisticated 
demands of your document has been made 
easier and more accessible. 


There is also a separate !1stChars 
directory now which, when opened, will 
allow you access to the complete character 
set for the chosen printer driver: this, you 
will remember, used to be obscured behind 
the document window. Now - since it is a 
window in its own right - it can be 
dragged and placed anywhere that is 
convenient, should you need to include 
more than the occasional non-English or 
scientific/mathematical character. 
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1ST MAIL 


The extensive mailmerge facilities 
have not been enhanced in substance, 
though they are now easier to use because 
they conform to all the RISC OS protocols. 
They are also better and more concisely 
explained in the documentation, and some 
pretty useful and advanced operations can 
now be performed. 


CONCLUSIONS 


If you already have 1st Word Plus, 
here is an upgrade you should definitely 
make - although the upgrade price at half 
the cost of the product when new really is 
too high, particularly since the 
improvements are what Acorn themselves 
call “minor increases in functionality”. 


If you have not yet decided which word 
processor to go for, and prefer not to wait, 
lst Word Plus release 2 is probably the 
best of a somewhat mediocre bunch. 
Pipedream 3 is to be preferred if you want 
an integrated word processor and 
spreadsheet. 


Yet Ist Word Plus still has its 
drawbacks: no real hanging indents, no 
“dynamic dates” in the main word 
processor, and bugs still in the formatting. 
The Mailmerge option is powerful and 
easy to use. Incorporation of graphics is 
still not really up to much, but could be 
useful for simple line-art. 


Make no mistake, though: although a 
few weeks with this new version will leave 
you convinced that a more complete - 
maybe definitive - word processor must 
come along sooner or later, 1st Word Plus 
is likely to meet the bulk of your needs 
until it does. 


Product 1st Word Plus release 2 
Supplier Acorn Computers 
Fulbourn Road, Cherry Hinton, 
Cambridge CB! 4JN. 
Tal. (0223) 245200 
Price £91.94 inc. VAT 


The upgrade costs £50.05 inc. VAT and 
p&p only from Vector Services, 30 
Dennington Road, Wellingborough, 
Northants NN8 2RL (please include the 
original program disc). RU 
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MORLEY €.1-£-C-T-R-0-N-1-C- SHE” 


THE WORLDS MOST POWERFUL MICRO 


A3000 £649 
310 £899 
310M £959 


410/1 £1199 
420/1 £1699 
4440/1 £2499 


——_ 
THE BEST VALUE MEMORY UPGRADES 


O Easy to install simply plug in 


1 Meg upgrade gives you a total 
and run OQ . 


of 2 Meg on-board 


SPECIAL OFFER UNTIL JANUARY 1990 

BUY AN A3000 OR ACORNS DESKTOP 

PUBLISHER AND SAVE 20% OFF THE 
COST OF A MORLEY RAM BOARD 


THE A3000 OPTION ACORN FORGOT 


C) Easy to install simply plug in 


and run 


) High quality Japanese Drive 


Includes full fitting kit and 


LEADS & MISC. HARDWARE ETC. 


Arch Monitor Leads: 


SCART £8 
9 Way 'D* (Msync) £8 
Arch Serial Lead £6 
Arch Printer Lead £6 
BBC Printer Lead £6 
2 to | Printer switch £20 
3 to 1 Printer switch £30 
4 to 1 Printer switch £36 
64k Printer Butter £115 
256k Printer butfer £199 


instructions 

Dus! Drive Kit £125 
Printer Stand 80 col £15 
Printer Stand 135 col £19 
Tilt & Swivel Monitor 

Stand QW 
Monitor Stand/plinth 
BBC £13 
Master £4 
BBC/Master SCSI 
Hard Disc Interface £50 
Eprom Eraser £18 
Eraser with timer £23 


(NOTE switching units & print buffers come with printer lead) 


The Morley TELETEXT 
ADAPTER is now available tor 
the Archimedes. The specifica 
ion induding screen dumps etc., 
ia the same as ne BBC version 
but connection is via a Podule 
socket £125 
EXISTING USERS OF OUR B&C 
TELETEXT ADAPTER 
WE CAN UPGRADE THE UNIT 
FOR THE ARCHIMEDES FOR 
£35 


RING FOR DETAILS 


‘@ are now an Acorn dealer and 
sorvice contre. If you would like to 
have a look at the A3000 or any 
other Acorn’/Morley products 


please foal free to call in and 
discuss your requiroments with 
our staft. 


COMING SOON 
Morley Module Podule 


Allows trague vty required Modulus to be 
loaded into & non-voatie storage area on 


the poduie. Thus saving tn tedium of 
Staaiching through your Gscs for Ihe 
modules required 


O Fully compatible with all Acom 1 Meg board upgradeable to 3 
software including desktop Meg 
publisher 1 Meg Upgrade £150 
ry A must for all serious 3 Meg Upgrade 2415 
— Archimedes owners 1 Meg to 3 Meg £298 
Q Make full use of Acom’s 305 1/2 Meg £105 
powerful Desk-Top Publishing 400 Series 1 Mog £145 
package 400 Series 3 Meg £395 
ARCHIMEDES PERIPHERALS 
Colour Monitor £220 300/400 series 
Mono Monitor £73 Acorn Rom Podule £56 
Printer Lead £9 2 Slot Backplane £37 
A3000 4 Slot Backplane £53 
Monitor stand £29 VO Podule £80 
User port & MIDI Podule £49 Midi Podule £65 
Serial Uparade £19 20 Meg Hard Disc & 
Econet Upgrade £49 Controller £465 
Pipedream 3 £147 Acorn DeskTop Pub £149 
Risc Os Companion £49 Clares Pro Artisan £145 
ist Word + £69 Clares Artisan £29 
Autodesk CAD £79 Clares Toolkit £34 
Acorn PC Emulator £99 Clares Toolkit + £43 


Kit includes: 5.25° Teac 80 track drive; case: power supply; 
3.5° drive cradle: interface and leads 


A3000 SCSI PODULE 
A3000 WINCHESTERS 


Including SCS! Podule, drive, case and leads 


20 meg £465 30 meg £495 
40 meg £575 60-200 meg POA 


£169 
£149 


Tape 
Enciose chaque mace payable 
to MORLEY ELECTRONICS LTD. 


Morley House, Off Norham Road, North Shields, Tyne & Wear NE29 7TY, Tel: (091) 257 6355. Fax: (091) 257 6373 
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Part 6 - Forced Window Redraws, Closing Down the Wimp, 
and Error Handling 


by Lee Calcraft 


ast month we looked at the way in 
which windows are opened and redrawn 
by the Wimp. We conclude this theme by 
examining how a task can force a window 
to be redrawn. We will then move on to 
look at how to close down a task, and how 
error handling may be dealt with. For 
completeness, we also include a table 
(figure 1) giving the parameter block 
returned by SYS “Wimp_RedrawWindow” 
and SYS “Wimp_GetRectangle”, referred 


to last month. 


RO=0 No more updating required 
RO>0 Further updating required 


Ri Points to a parameter block: 
R1+0 Window handle 

Ri+4 Visible area min x coord 
R1+8 Visible area min y coord 
R1i+12 Visible area max x coord 


R1+16 Visible area max y coord 

R1+20 Scroll x offset rel to work area origin 
R1+24 Scroll y offset rel to work area origin 
R1+28 Current graphics wind min x coord 
R1+32 Current graphics wind min y coord 
R1+36 Current graphics wind max x coord 
R1+40 Current graphics wind max y coord 


Figure 1. information returned from 
SYS “Wimp_RedrawWindow" and 
SYS “Wimp_GetRectangle” 


FORCING A REDRAW 


Under normal circumstances the 
initiative for redrawing a window comes 
from the Wimp itself. For example, a 
previously obscured part of the window 
may have been uncovered, or the user may 
have scrolled the window. In either case 
the task is called on where necessary, 
through the Wimp poll routine, to update 
the window as we saw last month. 


However, there will be many cases 
where the task needs to initiate an 
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update. For example, a clock may need 
updating, or a character may have been 
typed into a text editor, or a database 
search routine may have found a 
matching string. In such cases (as always) 
the task must not write directly to the 
window, since it might be partially, or 
even wholly, obscured. It must instead 
force the Wimp to perform the updating, 
and there are two ways in which this may 
be achieved: 


1. Call SYS “Wimp_ForceRedraw” 
(SWI &400D1), supplying the area to 
be updated. This causes the marked 
area to be registered as invalid. The 
Wimp will then in due course set 
about its renewal - probably by 
returning a redraw window request at 
the next Wimp poll. 


2. Call SYS “Wimp_UpdateWindow” 
(SWI &400C9), supplying the area 
to be updated. In this case, the 
Wimp immediately initiates the 
redraw, returning the co-ordinates 
of the first rectangle to be redrawn 
by the task. The task should 
comply, and repeatedly call SYS 
“Wimp_GetRectangle” until the Wimp 
signals that there are no more 
sections which need updating. 


Both approaches are very similar, but 
the latter gives immediate results, 
because the window updating does not 
have to wait for all other concurrent 
tasks to perform their next Wimp poll. 
The other difference is that in the latter 
case, the Wimp does not clear each 
rectangle before its co-ordinates are 
passed to the task for updating. This can 
be particularly useful when moving 
objects across a display using EOR 
plotting logic, such as when using rubber 
banding techniques. 
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However, because the latter method 
uses more code, we will opt for the former. 
In this case, all you need to do is to make 
a single call to “Wimp_ForceRedraw” with 
the following data in registers RO-R4: 

RO=window handle (-1 means whole 
screen) 

Rl=min x co-ordinate of area to redraw 

R2=min y co-ordinate of area to redraw 

R3=max x co-ordinate of area to redraw 

R4=max y co-ordinate of area to redraw 


The call can be made in one of two ways: 
you can set RO to -1, in which case the co- 
ordinates refer to the screen origin, or 
better still you can set RO to the handle of 
the window to be updated, in which case 
the co-ordinates refer to the work area of 
the window. 


We will adopt the latter approach. This 

results in the following call: 

SYS "Wimp_ForceRedraw", whandle%, xmin, ymi 
n, xmax, ymax 
where whandle% is the 
handle of the window, and 
the other four parameters 
are as indicated in figure 2. 
There are two important 
points to note in supplying 
the parameters for this 
call. 


The first is that although 
the measurements are made 
relative to the work area 
origin, the first of the two 
vertical parameters (ymin) is 
numerically larger, and it is 
very easy to accidentally 
reverse the order in which 
they are given. Secondly, 
because all measurements 
are made relative to the 
work area origin (which is 
usually at the top of the work area), both 
ymax and ymin will always be either zero 
or negative. 


To try out a forced redraw, you could 
insert the following lines into the original 


test program from part 1 of the series. 
The effect will be to update the clock 
display once every second. You may 
remember that in the original example 
the clock was only updated if the window 
was scrolled or uncovered, The additional 
lines cause a check to be made on the 
TIME variable whenever the Wimp 
returns a reason code of zero during the 
Wimp poll cycle. If the time has moved on 
by a second or more since the last update, 
then a “Wimp_ForceRedraw” will be 
called. 

115 timet=TIME+100 

435 WHEN 0 :IF TIME>=timet THEN SYS "Wi 
mp_ForceRedraw", whandle%,0,-100,500, 0:time 
$=TIME+100 


Incidentally, note that the Wimp 
provides a special call - SYS 
“Wimp_Pollldle” (SWI &400E1) which 
allows a task to specify a time before 
which null reason codes will not be 


v4 work area origin 


Figure 2. The relationship between the work area 
origin, and the region to be updated In a forced redraw 


returned to it. This saves Wimp_Poll 
time in applications such as clocks which 
need periodic updating. See the PRM 
page 1246 for further details. Note also 
that we have used the TIME variable in 
this simple example, though of course 


RISC User March 1990 


Mastering the Wimp 


this is inherently unreliable because it 
could be reset by any other concurrent 
task. Fortunately RISC OS provides a 
much more reliable clock, and a call with 
which to read it. Thus SYS 
“OS_ReadMonotonicTime” (SWI &42) 
reads the number of centiseconds since 
the last power-up or hard reset. It is 
used as follows: 
SYS "OS ReadMonotonicTime" TO time 


If you run the test program with lines 
115 and 435 inserted as above, you will 
see that there is a slight flicker each time 
that the clock is updated. This can be 
reduced by updating a smaller part of the 
window. To do this we can just alter the 
co-ordinates which are supplied to SYS 
“Wimp_ForceRedraw”. But you would 
then need to check to see if the day and 
date needed updating, and increase the 
size of the rectangle accordingly in such 
cases. 


Even in this very simple example you 
can see some of the problems involved in 
updating a window. They become 
exceedingly complex when the work area 
contains large quantities of editable text. 
As soon as the user types a single 
character at the keyboard, the window 
must be updated, and if the cursor is 
somewhere in the middle of a document, 
the ramifications from a single keypress 
can be enormous. All text beyond the 
cursor may need to be rewritten, and this 
can be a lengthy business, even in 
machine code - and matters are made 
much worse if the text is in an outline font 
rather than the system font. 


WIMP CLOSE DOWN 

We have now looked at all aspects of 
our original test program except for the 
close-down sequence by which a task is 
removed, and the method by which errors 
are handled. We will now take these in 
order. 


Under normal circumstances a task 
will be closed down for one of two reasons 
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- either the user has quit the Desktop 
using Ctrl-Shift-F12 (or by selecting Exit 
from the Task menu), or he has elected to 
close down a particular task either by 
clicking on the Close icon on the task’s 
main window, or by selecting Quit from an 
icon on the icon bar or from the Task 
Manager display. Information about all 
these user actions is received via the 
Wimp poll. 


If the user clicks on a window's Close 
icon, a reason code of 3 is returned. In the 
simplest case the task should respond to 
this in one of two ways. If the Close icon 
simply closes the window, then SYS 
“WimpCloseWindow” (SWI &400C6) 
should be called, while if closing the 
window terminates the task, then SYS 
“Wimp_CloseDown” (SWI &400C0) should 
be called. 


The latter occurs in our original test 
program which, has only one window, 
and which does not have an icon on the 
icon bar. If you look at the program 
listing from part 1, you will see that in 
response to a reason code of 3 returned 
by the Wimp poll, the flag quit% is set to 
TRUE. This in turn causes the Wimp 
poll loop to be exited. SYS 
“Wimp_CloseDown” is then called as 
follows: 

360 Sblock%="TASK" 

370 SYS "Wimp CloseDown", taskt, !block$ 
This call informs the Wimp that the task 
is to be irretrievably removed, and all 
resources allocated to it can be placed 
back in the Wimp free pool. 


When the Wimp wants to close down 
one or more tasks (because the Desktop 
is to be exited for example), it uses a 
different approach. It makes use of 
reason codes 17 and 18 which are 
general message-passing codes. Tasks 
can communicate between one another 
using these reason codes. When a close- 
down is imminent, the Wimp will pass 
a message of type 8 “pre-quit”, and 
tasks may protest at this point if they 
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"“PriRS i 
ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard” machines 
A powertul and practical tool for Research, Industry, Business, and Teaching 
Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 


There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 


CAMBRIDGE INTERNATIONAL SOFTWARE LTD 
8 HERBRAND ST LONDON WCIN 1HZ 
TEL: 01 833 4023 FAX: 01 837 6077 


ARCHIMEDES SPRING FAIR 
MARCH 10-11th 1990 
at 8 Herbrand St L 
100's OF ARCHIMEDES PRODUCTS UNDER ONE ROOF 


Cambridge International Software Dabhand Computing 

Dabspress Computer Concepts Minerva 

Simtron Superior Software Acorn User 

Overseas Media Distributors PRES .....and many more 
5 Mins walk from Euston, Kings X & St Pancras. 
Opposite Russell Sq Tube (Piccadilly line) 
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have data which they think the user 
may wish to save before the task is 
closed. 


After this, a message of type zero is 
sent by the Wimp. This is a firm 
instruction to quit, and tasks may no 
longer tarry. In our example program, we 
only look for a message of 
type zero, since there is no 
user data which might 
need saving. This is done 
by looking for a reason 
code of 17 or 18, in our 
Wimp poll CASE state- 
ment, and then checking 
block%!16 for the message 
number. If it is zero, then 
quit% is set to TRUE. All 
other messages are 
ignored, thus: 

470 WHEN 17,18:IF block%! 
16=0 THEN quit%=TRUE 


As you will probably 
gather, there is a great 
deal more that could be 
said about message passing, and you are 
referred to the PRM pages 1253-1269 for 
further details, though the foregoing 
should be sufficient for most purposes. 


ERROR HANDLING 


If you take a look at our original test 
program, you will see that there are two 
error handling routines. The first simply 
closes down the task using the same two 
lines of code which appeared above, as 
lines 360 and 370. This will handle any 
errors encountered in the program before 
the main Wimp poll loop is reached. 


The second error handler is invoked 
immediately above the Wimp poll loop at 
line 320: 

320 ON ERROR IF FNwimperror THEN END 

This makes use of SYS 
“Wimp_ReportError” (SWI &400DF) to 
automatically display an error box 
containing the error number (ERR is 
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stored at block%!0 on line 1150), and the 
REPORT string, and provide user- 
selectable OK and Cancel options. In fact 
many aspects of the error box are 
customisable through flags set up in R1 - 
see the PRM pages 1243-1244 for details - 
though the form used here is probably the 
most useful. 


The error box generated automatically by SYS 
“Wimp_ReportError” 


The call returns the user’s response 
in register R1 (=1 if OK is selected or 2 
if Cancel was chosen). This is retained 
in response%, and is used to set the 
function to TRUE if the task is to be 
abandoned, and FALSE otherwise. If the 
user selects Cancel, the Wimp 
automatically closes the task, so all the 
program need do is to end - achieved in 
line 320. If the user opts to continue by 
clicking on OK, the program simply 
continues at the start of the Wimp poll 
REPEAT loop. It is vital that the ON 
ERROR statement be at exactly this 
point in the program. 


At last we have covered the principles 
behind the relatively simple test program 
from part 1 of the series. But there remain 
a number of important areas that we have 
not yet touched on. In the forthcoming 
issues we will be treating the major topics 
of icons and menus, and will be looking at 
a variety of example programs. AU 


51 


& ROBICO ADVENTURES 
- FOR THE ARCHIMEDES 


STRANDED! £29.95 


The brilliant new adventure from the leaders in Acorn 
adventuring! 


It is the far distant future and the attractions of inter-galactic travel through the ever- 
expanding universe have tempted you into stowing away on board a large Starfreighter. 
The penalties, if caught, are severe ... but surely you have sufficient intelligence and 
resourcefulness to meet the challenge? 


Stranded! It is an enthralling science fiction adventure with over 220 locations, nearly 
100 objects and over 130K of text. It features several high resolution colour graphics 
screens, mouse driven input and an advanced parser. Buy it and you won't be 
disappointed! 


RISEIN CRIME £29.95 


Can you rid yourself of the shackles of a conformist, mind-imprisoned society? Mouse 
driven input, advanced parser, 396K of text, 400 locations, 150 objects and several high 
resolution graphics screens make this an adventure to remember! 


FUGITIVE'S QUEST £29.95 


You have been convicted of a murder you did not commit. Can you escape and prove 
your innocence? 230 locations, 80 objects, an advanced parser, mouse driven input 
and several full colour, photo-quality illustrations combine to create a must for 
adventurers! 


ENTHAR SEVEN £29.95 


Your interplanetary Space Hopper begins to decay. You have to land safely and then 
explore the planet in order to regain the freedom of the stars. 450 locations, 80 objects, 
1200 messages, an advanced parser and some of the best graphics you will ever see 
make Enthar Seven a true mega-adventure! 


Robico Adventures are available from all good computer stores or direct from 
ROBICO, 3 FAIRLAND CLOSE, LLANTRISANT, MID GLAM CF7 8QH Tel. (0443) 227354 


Please make your cheque payable to 'Robico' | | 
or you may pay using your ACCESS card. 


Presenter Il 


Mike Williams looks at the latest version of Lingenuity’s business 


graphics software. 


| was Lingenuity’s earlier 
software for the presentation of graphs 
and charts, and was reviewed in RISC 
User Volume 2 Issue 1. Now Presenter II 
is available with more features, full RISC 
OS compatibility, and a higher price to 
boot. As before you get a disc and a slim 
manual, but the latter is now produced to 
a much better standard. 


In use, Presenter is now installed on 
the Desktop icon bar. Curiously there 
seems no way of directly creating an 
empty data entry sheet. Any of the 
example files provided may be dragged to 
the Presenter icon, and the data entry 
window complete with data is revealed. 
Using the Menu button to select the Clear 
option will then clear the worksheet, and 
the blank sheet can be saved for whenever 
you want to start with new data. 


3D bar chart from data supplied 


The data entry window itself is very 
similar to the original. Entering data is 
little different, but now caters for 26 
columns (or data sets) of up to 55 values 
(rows), compared with 9 by 25 before. 


Pressing the Menu button over the 
data entry window reveals a revised 
option menu. Selecting Graph type leads 
to the opening of a further window 
displaying the data in graph form, using 
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one of four graph types. I still feel that the 
range of graphs allowed is too limiting, 
though a ‘scattergram’ including optional 
lines of best fit, previously a particular 
paint of criticism, has been added to the 
ist. 


Within the graph window a further 
menu can be displayed. One of the most 
important entries is Options which 
controls all the different characteristics of 
graph displays quite comprehensively. The 
other menu choices here also depend on 
the type of graph chosen, but all allow the 
graph to be saved as a Draw file, This can 
then be imported into other applications 
such as Pipedream and Acorn DTP, as 
well as into the Draw application for 
enhancing and scaling the graph display. 
Graphs in the form of Draw files can also 
be printed by dragging the file icon to a 
previously installed printer driver. 


Two further facilities are provided. 
Data in the form of CSV files (comma 
separated values) - a standard database 
format - may be both imported and 
exported. There is also a utility to convert 
Presenter I files to Presenter II format. 


The obvious competitor to Presenter II 
is Minerva’s GraphBox (reviewed in RISC 
User Volume 2 Issue 7). This offers 20 
different forms of graph display but is 
twice the price of Presenter II. That seems 
to be the only major point of difference - 
and an expensive one at that. Presenter II 
itself now costs over 30% more than 
Presenter I, and I remain disappointed 
that the range of graph types has not been 
expanded further. However, at its price, 
Presenter II has to be the best business 
graphics package for the Archimedes 
provided that the four graph types 
provided (bar chart, line graph, pie chart 
and scattergram) meet your needs. 


Product Presenter Il 
Supplier Lingenuity 
Wood Farm, Linstead Magna, 
Halesworth, Suffolk IP19 ODU. 
Tel. (098) 685477 
Price £39.95 inc. VAT AY 
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MULTIPLE FUNCTION KEYS 

Lee Calcraft 
The 13 programmable function keys (F1-F12 
plus the Print key) are an extremely useful 
resource - so useful that 13 never seems to 
be quite enough. However, it is an easy 
matter to double up on the number of 
functions that may be allocated. With a little 
subterfuge you can assign two different 
functions to each key. One is performed if the 
key is pressed on its own, the other if the 
Escape key is held down at the time that the 
function key is pressed. 


To achieve this, all you need to do is to 
include a check for the Escape key in the 
definition of each key concerned. This is 
performed using the negative INKEY 
function. The examples below should clarify 
the technique. They program function key F1 
to emit a low pitched beep on its own, and a 
high pitched beep if it is pressed with the 
Escape key held down. 


Function key F2 executes one of two star 
commands. If F2 is pressed on its own it 
executes *TEST1, while with the Escape key 
pressed, it executes *TEST2. 
*KEY1 IF INKEY({(-113) THEN SOUND 1,-1 
5,200,4 ELSE SOUND 1,-15,50,4|M*KEY2 
IF INKEY(-113) THEN OSCLI("TEST1") E 
LSE OSCLI("TEST2") |M 


The |M at the end of each line generates a 
carriage return within the key definition. 


RESET FOR SAFETY 
Jeoffrey Nell 
If you are running a Basic program outside the 
Desktop, you can normally exit from it by 
pressing Escape. This conveniently leaves the 
program in memory ready for editing. But in 
certain cases, such as an error in an error 
handler, a machine code loop with no exit, or 
where *FX 200 has been used to disable Escape, 
you may need to reset the machine in order to 
stop the program. If you use Ctrl-Break for this 
(hold down the Ctrl key, and press Break), you 
will probably lose your Basic program. In other 
words, if you type OLD, you will get the 
message: 

Bad program 
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However, if you press the Reset key (located 
beside the mouse socket at the rear of the 
keyboard) instead of Ctrl-Break, you will be 
able to escape from most situations, leaving 
your Basic program intact. Once Reset has 
been pressed, just type OLD to restore your 
program. 


Incidentally, the reason for the loss of the 
program after Ctrl-Break or Ctrl-Reset is 
that MEMC, the memory manager, 
reallocates physical RAM to the various 
logical RAM addresses currently used by the 
machine. The result of this is that any Basic 
program present before the reset, is 
remapped to a new address (rather than 
being corrupted). It would therefore be 
possible to find it again and restore it, but it 
is much easier to make sure that it is not 
lost in the first place. 


When using the Reset key, note that it places 
the contents of function key F10 into the 
keyboard buffer after its resetting action, so 
it may be prudent to only program F10 for 
operations that would not be a nuisance 
when executed as a side effect of the reset 
(e.g. don’t set it up to perform a screen dump 
to your printer, use another key for this). 


CONFIGURING MODE AND WIMP 
MODE 


Lee Calcratt 
The Archimedes has two mode configure 
commands: 
*Configure Mode <n> 
and*Configure WimpMode <n> 
Both take a mode (n) as parameter, but they 
have different effects. 


The first sets the default mode which the 
machine will enter after a power-up, a reset, 
or after leaving the Desktop. The second sets 
the default mode for the Desktop itself. If 
you alter mode from within the Desktop 
using the palette icon, or from a multi- 
tasking application, the new mode becomes 
the default Desktop mode, and will be used 
whenever the Desktop is re-entered. A reset 
(or power-up) will cause the default to revert 
back to that set with *Configure WimpMode. 
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THE ADJUST BUTTON 

Robert Picktord 
Users may be aware that, when using an 
application which has been correctly 
written following the RISC OS guidelines, 
choosing an item from a menu with the 
Select button removes the menu structure 
from the screen once the selection has 
taken place, while using the Adjust button 
leaves it in place. You may not be aware, 
however, that when formatting or backing 
up discs, if you press Adjust in response to 
the prompt: 

"Press SPACE or click mouse to continue” 
the disc operations menu remains on the 
screen, with the mouse pointer exactly where 
you left it. This saves a great deal of time 
and patience if you are carrying out several 
successive disc operations. 


PRINTER CODES IN JEDIT 

Alan Wrigley 
If you print a text file using the Acorn 
printer driver !PrinterDM, the text will 
simply be printed in the printer’s default 
font and style. It is possible, however, to 
include control codes in a file created with 
!Edit. If you press certain keys with Ctrl 
held down, a hexadecimal number will 
appear with square brackets round it. This 
signifies that a byte with the value within 
the brackets has been inserted in the text, 
e.g. “[Oc]”. Note that simply typing the string 
“{Oc]” from the keyboard will NOT have the 
same effect. 


This facility does not work with all 
characters; for example, Ctrl-M behaves in 
'Edit like a carriage return, which is not 
surprising as it is the equivalent of the 
carriage return code 13. More importantly, 
from the point of view of including printer 
codes, Ctrl-(, which would normally produce 
character code 27, i.e. Escape, is ignored by 
'Edit. You may think that will defeat the 
purpose of this hint, but in fact it is possible 
to get around this. Wherever you require an 
Escape code, enter into the text a character 
which is normally unused, for example the 
international currency character (above the 
pound sign). Then using the Find option 
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from the Edit sub-menu, alter all 
occurrences of the unwanted character to 
“\xl1b”, making sure the “Magic characters” 
option is turned on. You will now see “[1b]” 
appear in the text in all the specified 
places. 


To include a string of printer codes in the 
text, use the method described above for 
any codes below 32, while for codes between 
32 and 126 simply type in the character 
whose ASCII code you require 
(Alternatively, hold down the Alt key, type 
in the ASCII code number using the 
numeric keypad, then release the Alt key). 
So to print out your text in emphasized 
print, for example, you could include 
“[1bJE” at the start of the text. To print a 
section in italics would require “[1b]4” 
before and “[1b]5” after. 


TOO MANY FONTS FOR ACORN’S 
EDIT 


David Pilling 

If you have more than 12 outline or bit- 
mapped fonts present in your font directory, 
and you try to install Edit, it will crash 
without explanation. Until Acorn releases a 
new version of Edit, the only way around the 
problem seems to be to restrict the number 
of fonts to 12. 


BIT-MAPPED OR OUTLINE FONTS 
Lee Calcratt 
If you are not sure whether fonts which you 
hold are of the new outline variety or the old 
bit-mapped sort, just look in the relevant 
directory for the font files themselves. Each 
style should have two files. One will be 
called “IntMetrics”, while the name of the 
other can be used to determine which type of 
font you have: 
Name Type 
x90y45 Bit-mapped 
Outlines Outline 
In the latter case, the new Configure option 
“FontMax” will take effect - see this month’s 
Technical Queries for further details. ay 
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* Full feature word processing ® Full capability DTP * Multiple documents in memory * Multiple 
windows on each document * Any scale view from 19-90% * Automatic hyphenation 
* Built-in spelling checker * Spell check as-you-type * Full 24- 
bit RGB, CMYK & HSV colour control * Fast character 
mode printing * 300K free workspace ona I Mbyte 
machine * Supplied with 13 outline fonts * 
Flowing graphics with text © Automatic 
index generation * Automatic contents 
o generation * Automatic abbreviation 
expansion e Automatic file conversion 
from other WPs © Virtual memory 
system - unlimited document size 
* Simple to use - only 5 main menus 
* Word count * Scaled printing * 
portrait & landscape pages in one 
document * active master pages 
* thumbnail pnnting © rotated 
printing * left/right only printing 
e pamphlet printing ° collated 
printing © pause between pages * 
cut/ copy. /paste between documents 
= multiple master pages © fully 
customisable start-up ° 
programmable key short aus bd 
overlaying styles * styles can be 
applied to any part of a paragraph 
* dynamic memory usage * searc 
& replace for styles and codes 
© search & replace with wildcards 
* case-sensitive search & replace * 
auto-page numbering * roman 
numbering option * page 
numbenng Start at any value e 
multi-line headers & footers * 
graphics in headers and footers * 
graphics on/off options for screen 
& print * style merge from other 
documents ® style template 
documents * condensed & 
expanded text * lefi, centre, right 
and decimal tabs * each style can 
have its own nuler ® single & double 
underline options * text strikeout 
* underline colour control * mule- 
offs * hyphenation control on 
individual words * hyphenation 
exception dictionaries e 
programmable tab leader characters 
* intemal accuracy to 1/72,000ths 
inch * horizontal and vertical 
kerning to 1/1000ths em * text 
flow around frame control (both 
sides, either side or neither side) * 
guide frames * controllable frame 
snap * embedded graphics frames 
in text * embedded graphics on the 
line © 90 to page & chapter * two 
guess-misspelt-word options e word 
anagram solutions * crossword solving 
facilities * 8 user dictionaries * auto-load 
user dictionaries on start-up * user dictionaries 
compatible with Spellmaster * all measurements can 
he Spec ified as inches, millimetres, centimetres, meters, powts, 
feet, yards or picas * abbreviation expansion as you type * word 
substitution as you type * insert current date & time options * controllable preferences for measurement 
units & default scale views * character mode printer drivers for Epson & Laserjet printers * 


If other programs can offer all these features, 


then they might be as good as Impression. 


Computer Concepts Ltd 


Gaddesden Place 
Hemel Hempstead 
Herts HP2 6EX 
Tel. 0442 63933 


Postbag ~> 


COMPUTER CONCEPTS DEFENDS ITS 
DONGLE 


example, three pages are devoted to 
describing how to attach a sprite to a file, 


I know that Mr.Lowe (see Postbag, RISC 
User Volume 3 Issue 2) has had real 
problems with a dongle on a previous 
product fro 


mm another company on a different 
machine, because he has written to every 
magazine and told them so. I really do 
sympathise, but I don’t see why he should 
feel that he will have a problem with ours. 


Our main criterion has been to develop a 
form of protection that interferes as little as 
possible with the use of the program, and we 
feel that a dongle is better at this than the 
alternatives; once plugged in it becomes 
invisible, it does not interfere with other 
software or hardware in any way, it does not 
have to be activated or loaded every time the 
program is started, and it does not prevent 
backup copies or copying to a hard disc. 


Anyone who has any doubts about 
Impression and its use of a dongle can buy a 
copy and try it out for themselves, knowing 
that if they find any trouble whatsoever they 
can always send it back for a refund. After 
all, ‘No Quibble’ refunds are one of the 
advantages of software protection. 


For multiple users, site licences are available 

allowing any dongle at the site to be used 
with any of their copies of Impression. 

Catherine Moir 

Computer Concepts 


We are pleased to print this reply trom 
Computer Concepts, and | will leave readers to 
judge for themselves the merits of dongles. 


Interestingly, letters from other readers have 
only been against the use of dongles, and 
indeed other forms of software protection, That 
is understandable, but it is difficult to determine 
a solution which best serves the legitimate 
requirements of both providers and users. 


CATERING FOR BEGINNERS 


I accept that many of your readers are novice 
computer users, and therefore need an 
introduction such as your Into the Arc series. 
However, do you not feel that this sort of 
material belongs to a magazine such as 
Acorn User which is aimed at just such a 
type of reader? In Volume 2 Issue 10, for 
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and a sprite system which is now obsolete. 


Who is this aimed at? If a programmer is 
able to write applications using RISC OS 
that needs a sprite, he or she probably owns 
a copy of the Programmer’s Reference 
manual and can find the information for 
themselves. If they don't own the PRM, how 
have they managed to write an application 
other than one derived from example 
programs in RISC User? 


So the text is not useful to a beginner, and 
probably obvious to an experienced 
programmer. 

Robert Rainthorpe 


We believe that RISC User should cater for 
all Archimedes users; in that way the 
beginners of today have the chance to 
become the experts of the future. As the 
author of the article reterred to, | feel sure 
that there are many readers who maybe write 
quite modest programs in Basic, but who 
would like to turn these into an application 
which can be run from the Desktop. It may 
not be a fully multi-tasking application, but 
the result no doubt gives satisfaction to the 
user, who may not be prepared to pay the 
relatively high price of the Programmer's 
Reference Manual. 


DRAWING CIRCULAR ARCS 


I found your article on Draw (RISC User 
Volume 3 Issue 1) very helpful. However, I 
have one query. If I wish to draw, for 
example, kerb lines at a road junction (that is 
two lines at right angles and join them by a 
circle, then delete three quarters of the circle, 
I find Draw deletes the whole circle or 
nothing. Is there is a way of doing this? 
L.J.Colman 


The Draw application is object oriented - that 
is, it only knows about complete objects. Using 
the circle drawing tool creates a circle as just 
such an object, hence the result when you try 
to delete part of it. The only answer is to draw 
a free curve between the ends of the two 
straight lines, and then drag the two control 
points as described in the original article to get 
a circular shape. 
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DO I NEED RISC USER? 
I intend to buy an A3000 very shortly. In the 
meantime, could you tell me: 


I. Will I need to take RISC User, or are you 
starting a new magazine for A3000 owners? 
2. If I take RISC User will you be starting a 
new series for new owners, or shall I need to 
buy back numbers? 
3. If you recommend back numbers can you 
say which are most suitable for a RISC 
beginner like me? 

M.E.W.Cope 


The A3000 has the same ARM chip set, the 
same RISC OS operating system, and the 
same set of Applications Discs as the current 
Archimedes series. All programs which run in 
an Archimedes, run in an A3000 subject to 
sulficient memory being available on any 
machine, Thus RISC User is equally applicable 


INVOICING & ACCOUNTS 


New: V3 of The Account Book now available. 
Comprehensive small business accounts to trial 
balance. VAT approved. Absolutely the easiest 

program to use, with neat final books and hundreds |} 
of reports. No entry limits. "The Account Book gets | 
first prize for both price and performance”- 
comparison in Micro User-July "89. A true user- | 
friendly program. It succeeds admirably "-Beebug - 
Oct '88. And that was Version 2, V3 has many new 
features. £27.95. 

New: V2 The Invoice Program. Database, Invoices 
(unpaid and paid), Statements (individual and 
automatic), Stock presets, Debtor lists, Linking with 
The Account Book and loads more £27.95. 
You will not be disapointed!!-See review BEEBUG 


Dec’89. 
Special Offer; £49.95 if purchased together. 
Apricote Studios 
2 Purls Bridge Farm 
Manea 
Cambs 
PE15 OND 


Tel: 035 478 432 for information, help or to order. 


to both the Archimedes and the A3000. After 
all, the A3000 is an Archimedes 


We shall continue to publish a variety of 
articles, including items aimed particularly at 
newcomers to the Archimedes, but we will not 
explicitly repeat topics already covered. Many 
of the earlier issues contain items which are 
likely to be of interest, with the issues of 
volume two onwards (covering RISC OS) 
being the most appropriate (all new 
subscribers receive copies of the indexes to 
volumes 1 and 2). ArcScan II, our Archimedes 
based bibliography, also provides a 
comprehensive and effective index not only to 
all items published in RISC User, but also to 
Acorn’s Archimedes manuals as well - and with 
keyword searching references on all topics are 
easily found, We certainly recommend the 
back issue route, and all issues of RISC User 
are currently still kept in stock iy 


PROFESSIONAL 


Archimedes Software 


Tools#l 
Tools#2 


Tools#3 
Paint 16 
Paint 256 


Macro Assembler 


DemoDise 


Magnitier ColourStatistic 


RiscOsApp Scanners 
Digitisers (Arvis —- Wattord) 
advanced KeyCommands 


comming soon ask for it! 


please send us a SAE 


G.M.A.mbH Wandsbeker Chaussee 58 
2000 Hamburg 76 West Germany 
Tel; 0104940 2512415, Fax.; 01049- 40~-2502660 
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Technical Queries 


REDIRECTING PRINTOUT TO A FILE 


Dear Sir, 
| need to prepare a report in the form of 
a PostScript file which can then be 
ported to another system to which a 
PostScript printer is connected. | have 
the PC Emulator package, and this can 
be used to convert a file into DOS format, 
using GETFILE and PUTFILE, and this 
can then be transferred using a 5.25" 
disc. But how do | produce a PostScript 
file? | am aware that one of the 
Applications discs contains a PostScript 
printer driver, but I'm not aware that you 
can redirect the output to 2 file. 
P.Betts 


In fact, you can do exactly that. Once a 
printer driver has been installed on the 
icon bar, by double clicking on its icon in a 
directory viewer (see Applications Disc 1 
and the RISC OS Extensions Disc), 
pressing the Menu button on the icon bar 
icon allows you to specify a file which will 
be used to hold all subsequent output 
using that driver. You can then proceed as 
you describe, dragging a file to the printer 
driver icon. 


However, it does also depend on how the file 
to be printed was created in the first place. 
Some software (Pipedream for example) 
contains its own options for printout 
including its own form of printer driver. In 
this case printing cannot be accomplished 
with any of the Acorn printer drivers. For 
this to happen, the file to be printed must 
be of type ASCII (or Exec or Obey), or have 
been produced by software which knows 
how to use Acorn printer drivers. 


Mike Williams 
CONFIGURATION SETTINGS FOR 
OUTLINE FONTS 
Dear Sir, 
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| understand that Acorn’s Outline 
Font Manager provides some new 
configuration commands. Can you 
explain what these are? 
Bill Brown 
Acorn’s new Outline Fonts were discussed 
in Rise User Volume 3 Issue 2 (Of Printers, 
Drivers and Fonts). In order to handle 
these, Acorn has produced a new RISC OS 
Outline Font Manager, which replaces the 


Font Manager previously supplied with 
the Archimedes. 


As explained in the earlier article, using 
the Outline Font Manager results in the 
bit-map for each character being calculated 
from the information stored on disc, and 
this is then held in the font cache in RAM. 
As a result the use of outline fonts 
represents a trade-off between memory, 
speed and font quality. Quite sensibly, 
Acorn has realised that different users may 
not have entirely the same priorities in this 
respect, and has therefore provided a set of 
new Configure options (described in the 
PRM vol.4) to allow the user to optimise 
the trade-off to suit his own requirements. 
These will be described in turn. 


*Configure Fontmax <number>[K] 

This sets the maximum size to which the 
font cache may grow if the currently 
configured Fontsize is insufficient. The Font 
Manager will subsequently shrink the cache 
back to its normal size when any font is 
discarded. Fontmax can be specified as a 
number of 4K chunks or directly in ‘K’ 
(though memory is still allocated in chunks). 


*Configure Fontmaxl <number> 

Fontmaxl sets the maximum height in 
pixels at which bit-map files are used (if 
available); above this outline files are used. 
A bit-mapped file (an x90y45 file for 
example) will always be used if the exact 
size required is available, or if the size 
required is less than Fontmaxl. Using an 
existing bit-map is quicker than generating 
a bit-map from an outline font, but the 
larger the size of font required the better 
the result of using an outline font will be. 


*Configure Fontmax2 <number> 

If you wish to use anti-aliased characters, 
these require four times as much space in 
the cache and also take more time to 
calculate from the outline. Fontmax2 is 
therefore provided to set the maximum 
height in pixels below which characters 
will be anti-aliased. 

*Configure Fontmax3 <number> 

This sets the maximum size of character, 
again in pixels, whose bit-map will be 
stored in the cache. Any characters larger 
than this will be drawn directly on the 
screen as outlines and will not be cached. 
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The purpose of this is to prevent occasional 
large characters, such as headings, which 
may only be required once in the 
document, from taking over the entire 
cache. Note that because of the way they 
are drawn, characters larger than 
Fontmax3 in size cannot be anti-aliased. 


Before describing the remaining two 
options, a new concept needs to be 
introduced. This is “sub-pixel anti-aliasing”. 
The width of each character in the font is in 
fact defined to a higher precision than the 
pixels on the screen. As a result, slight 
discrepancies can occur in the positioning of 
characters. With sub-pixel anti-aliasing, 
four separate bit-maps of each character are 
held in the cache (separately for horizontal 
and vertical anti-aliasing). 


Their use is determined by the exact 
position of the character in relation to the 
pixel grid. This technique gives a 
noticeable increase in quality at the 
smaller sizes, but introduces a time 


penalty that most users will find 
unacceptable. Sub-pixel anti-aliasing also 
requires 16 times more font cache memory 
than a non anti-aliased font. 


*Configure Fontmax4 <number> 

This sets the maximum size in pixels at 
_ horizontal sub-pixel anti-aliasing is 
used. 


*Configure Fontmax5 <number> 

This does likewise for vertical sub-pixel 
anti-aliasing. The default setting for both 
these options is 0, and unless you require 
the ultimate quality from your fonts it is 
recommended that they are left as such. 


It is difficult to give any specific guidance 
on suitable values for any of the 
parameters as so much depends on the 
memory installed, the number of 
applications etc which may be occupying 
memory, and the user’s own requirements 
as far as trade-offs are concerned. 

Alan Wrigley © 


BEEBUG 
The Archimedes Specialist. .. Your Chance To Join The Team 


SOFTWARE DEVELOPMENT ASSISTANT 


As one of the leading software producers for the 
Archimedes we are looking for someone to join our 
team working on a number of interesting new software 
projects. 


Reporting to the Software Manager, the successful 
applicant's duties will include providing technical 
support, program testing and evaluation, writing 
specifications, overseeing software production and 
eventually managing 
complete projects. 
Although this is not a 
Programmers position, a 
knowledge of Basic and 
Assembler would be 
useful, together with a 
familiarity of popular 
application software. 


SENIOR TECHNICAL SUPPORT ADVISOR 


Internal promotion has resulted in a senior position in the 
Technical Support department being available. In 
addition to a high level of technical expertise and product 
knowledge on the BBC/Archimedes range the successful 
candidate will have the ability to supervise and organise 
the staff under his/her contro} in a busy department. 


TECHNICAL SUPPORT ADVISOR 


Our Technical Support team provides answers and 
advice on an extremely wide range of subjects, covering 
both software and hardware on the BBC Micro, Master 
and Archimedes computers. 


We are looking for someone who owns a computer 
themselves and can demonstrate their enthusiasm on the 
subject. Training will be given, although a certain level 
of knowledge concerning existing products will be 
necessary along with the 
ability to express yourself 
clearly in writing and on 
the telephone. 

Experience on PC 
Compatibles, Commodore 
equipment and Econet 
would also be a benefit. 


Apply in writing (enclosing a c.v.) to: 
rhe Personnel Manager, 117 Hatfield Road, St Albans, Herts. AL1 4JS 
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BEEBUG 


The Archimedes Specialists 
Beebug Hardware Upgrades for the A3000 and Archimedes 


BEEBUG 
Hard Drives for the 400/1 series 


The BEEBUG internal hard disc upgrades use 
only high quality mechanisms from respected 
manufacturer's such as NEC, Rodime and Seagate. 
All our drives are easy to fit. 


I All drives have an access time of less than 29ms 

— 40 & 53Mb drives feature autoparking 

— Full 12 months warranty 

~ 53Mb drive uses the top of the range Rodime 
‘drive as used in the Archimedes 440/1 

— All drives fully tested and formatted prior to 


despatch 7 

4 Free fitting (by appointment) if brought to our 
showroom 

— Backed by the resources of Beebug 

~ Full fitting instructions included 


0120G Beebug A400 20Mb Drive 
0121G Beebug A400 40Mb Drive 
0122G Beebug A400 50Mb Drive 


BEEBUG 
A3000 Disc Buffer 


An exciting new release for the A3000 allowing 
the connection of 5.25" drives to the A3000. Some 
of the features include: 


4 Connector for BBC-type 5.25" & 3.5" drives 

— On board switches allow drive mapping to be 
changed. eg. The internal drive could be made 
drive 1, and an external drive as drive 0 - ideal 
for the PC emulator 

“| Whole interface contained on an internal card 

— Easy to fit, supplied with full instructions 

“I will work with most drives that have an internal 
Power Supply Unit 

Can read DFS files with optional DFS Reader 

~ Internal and external drives can be double 
stepped to read 40 track discs 

— Full 12 months warranty 


0135C A3000 buffer 
0102B DFS reader 


Prices quoted are for BI 


BEEBUG 
A3000 Memory Upgrades 


The BEEBUG A3000 memory upgrades are 
available in either 1 or 3 Mb versions and are easy 
to fit by the user. This will give a total of either 
2Mb or a massive 4Mb of memory. 


By using the latest surface mount technology we 
have achieved a board size of a mere 256x46 mm. 


The 1 Mb board can be easily upgraded to 3 Mb at 
any time by the user, unlike some other boards on 
the market. 


— Easy to install with fitting instructions provided 
O Full 12 months warranty 

— 1 Mb expandable to 3Mb by the user 

— Uses latest surface mount technology 

— Free fitting (by appointment) if required 


0130D Beebug A3000 Memory 1Mb £164.95 
0131D Beebug A3000 Memory 3Mb £399.95 
0132C 1Mb to 3Mb upgrade £250.95 


BEEBUG 
Archimedes 5.25" Disc Buffer MK II 


A high quality buffer mounted neatly and simply in 
the back a 300 or 400 series Archimedes. 

Almost any 5.25" drive with a PSU may be used 
Up to four drives (two external, two internal) 
Full buffering of signal from computer 

DIP switches allow re-mapping of drives 


0795C 5.25" Buffer (305/310/440) £33.25 
0784C 5.25" Buffer (400/1 series) £33.25 
0102B DFS reader & 9.90 


BEEBUG Serial Link Kit 


A fast, convenient method of transferring data 
between the BBC Micro/Master and the Arch. 
A3000 users will require the A3000 serial chips. 


Transfer in both directions 

WIMP driven, easy to use software 
Compatible with both DFS and ADFS files 
Includes software, 3m cable and instructions 


0796C Serial Link Kit 417.25 


1e: (0727) 40303 FAX: (0727) 60263 


ail Cata r details on postal « 


